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PREFACE 


This publication gives a logic overview of 
the Advanced Communications Function for 


the Virtual Teleprocessing Access 


Method-Release 2, which is referred to in 
this publication as ACF/VTAM. It describes 
the high-level logic for ACF/VTAM as it 
operates with the system control programs 
OS/VS and DOS/VSE with the program product 
VSE/Advanced Function installed. 


This publication should be read to gain a 
general understanding of ACF/VTAM logic. 
The unique logic for the Multisysten 
Networking Facility is described in 
ACF/VWIAM Logic: Multisystem Networking 
Facility (see Related Publications below). 
The Teleprocessing Online Test Executive 
Program (TOLTEP) logic is described in the 


ACF/VTAM 
| Release 2 | 
| Logic: Overview 


LY38-3021 


ACF/VTAM 

Release 2 

Logic: Base System 
Vol 1 LY38-3022 
Vol 2 LY38-3024 


ACF/VTAM 

Release 2 

Data Areas 
LY38-3026 


ACF/VTAM 

Release 2 

Diagnostic Techniques 
SY38-3020 


ACF/VTAM. 

Release 2 

Execution Sequences 
LY38-3028 


TACE/VTAM ~ 
| Release 2 | 

Control Block Overview | 
L_ LX27-0004 


ACF/VTAM publications for each operating 
system. Figure P-1 shows the relationships 
among the ACF/VTIAM service publications. 


ORGANIZATION OF THIS PUBLICATION 


This publication is divided into two parts: 


@ Part 1, “Overview of ACF/VTAM," 
describes the general way that ACF/VTAM 
works and the interfaces between major 
groups of routines. Control blocks 
necessary for ACF/VTAM functions are 
described in Chapter 2. For a complete 
description of the data areas, refer to 

the publication ACF/VTAM Data Areas. 


Figure P-1, ACF/VTAM Release 2 Service Publications 
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e Part 2, “Components of ACF/VTAM," 
consists of 16 chapters, one for each 
ACF/VTAM component. A component is a 
collection of ACF/VTAM modules that 
perform related functions. The | 
ACF/VTAM logic manuals describe 
ACF/VTAM at the component, subcompo- 
nent, and module levels. With the 
coding documented in this manner, any 
function can be traced down to the 
level that is needed. For example, to 
find out how the Physical Unit Services 
operates, refer in this publication to 
Chapter 14, "Physical Unit Services." 
If more detailed information about 
Physical Unit Services is needed, refer 
to the detailed description in the 
ACF/VTAM logic eee for your 
systen. 


Most chapters in Part 2 contain an overview 
diagram of the method of operation of the 
component. The conventions used in these 
diagrams are explained at the beginning of 
Part 2e | 


RELATED PUBLICATIONS 


SBE AON CBE ON CE EEE LEP TREES COED 


Before reading this publication, you should 
be familiar ee the external erece brace 
tion: Concepts, SET! 0463. To obtain a 
complete description of ACF/VTAM from the 
highest functional level down to the nore 
detailed module level, you should use this 
publication in conjunction with the follow- 
ing appropriate publications: 


e For DOS/VSE 


- ACF/VTAM Logic: Base System, Volume 
1, LY38-3022 : 


-  ACF/VTAM Logic: Base System, Yolume 
2, LY38-3024 


e For OS/VS 


- ACF/VTAM Logic: Base System, Volume 


e ACF/VTAM Data Areas (OS/VS), LY38-3030 


A graphic overview of ACF/VTAM control 
blocks is given in: 


© ACF/VTAM Control Block Overview 
(DOS/VSE) , LX27-0004 


® ACF crass Control Block Overview 
 “(OS/¥S1), LX27-0009 


°  ACF/VTAH Control Block Overview (0S/¥S2 
MWS), LX27-0013 ania 


The execution sequences of nodules to 
process selected application program 
requests are described in: 


e ACF/VTAM Execution Sequences (DOS/VSE) , 
LY38- ~3028° | 


e. ac F/VTAM Execution Sequences (sas, 
LY38- -3031 


e ACF/VTAM Execution sequences (OS/Ws2 
MVS), LY38- -3035 


ACP/VTAM Uragnontse information is given 
is * 


° — ACE/VTAM Sade Paes 
— (DOS/VSE), SY38-3020 


e AC F/VTAM Diagnostic Techniques (OS/VS) , 
SY38-3029 


The logic for the Multisystem Networking 
Facility of ACF/VTAM is described in: 


e ACF/VTAM Logic: Multisystem Networking 
Facility, LY38-3023 


The logic for the Encrypt/Decrypt Feature 
is described in: 


e ACF/VYTAM Logic: Encrypt/Decrypt 
Feature, LY38-3025 


Notes: 


1. In this publication, references to 
OS/VS are provided for planning 
purposes only. 


2. All references to ACF/YTAM assume 
Release 2 in this publication. 


3. Ensure that all DOS/VSE publications 
have been modified by the appropriate 
VSE/Advanced Function supplements. 
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CHAPTER 1. OVERVIEW OF ACF/VTAM OPERATIONS 


INTRODUCTION TO ACF/VTAM 


The Advanced Coamunications Function/Virtual Teleprocessing Access 
Method (ACF/VTAM) Release 2 is used by application programs to control 
data transmission to and from terminals in a data communications | 
hetwork. Communications controllers (3705s) are programmable devices 
that control the flow of information between ACF/VTAM and the remote 
terminals in the network. Because many access method functions are 
‘ performed in the communications controllers, the application programs 
can communicate within the network without regard to how they are 
attached to the system. Thus, communication lines and communications 
controllers are transparent when coding application programs. ACF/VTAM 
provides the application programmer with macro facilities that allow for 
this comaunication. 


In addition to its primary role of transmitting data, ACF/VTAM provides | 
network-control and network-sharing capabilities. ACF/VTAM commands 
allow the network operator to redefine the network by activating or 
deactivating any part of the network. The operator can give ACF/VTAM 
the use of terminals, lines, communications controllers, or application 
programs or can terminate ACF/VTAM. The operator can monitor the data 
communications network by displaying status information about any device 
or application program. Diagnostic (debugging) facilities can also be 
controlled by altering the.data comaunications network. The we 
network-sharing capability allows multiple application programgs to share 
leased, multipoint communication lines in the network. Because of this 
sharing capability, different programs can communicate with different 
terminals or nodes on the same line simultaneously. Figure 1-1 illusr 
trates an ACF/VTAM network. 


Four operations are involved in setting up and running an ACF/VTAM domain: 


1. Initialization, during which ACF/VTAM is started in the host 
operating systea. 


2. Network configuration definition, during which the parts of the 
network and their relationships are defined and made available to 
ACF/VTAH. 


7 3. Establishing sessions, which involves identifying application 
) . programs to ACF/VTAM and establishing sessions between logical 
| units (for example, devices and application programs). 


a) 4. Processing I/0 requests, issued by application programs or initi- 
| ated by logical units in session with application programs, and 
controlling the flow of data through the domain. | 


The first two operations must be performed before ACF/VTAM can be used; 
the third and fourth operations are performed on a continuing basis. 


This chapter describes how ACF/VTAM establishes the operating environ- 
ment and processes transaction requests from the application programs. 
The chapters in Part 2 provide more detailed descriptions of the 

_ACF/VTAM components (Figure 1-2). Details beyond this level are 
contained in the ACF/VTAM Logic Base System, Volumes 1 and 2. (See 
Figure 1-3.) | 
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Figure 1-1. Illustration of an ACF/VTAM Network 
INITIALIZING ACF/VTAM 


The ACF/VTAM initialization routines, which start ACF/VTAM in the | 

operating system, are invoked when the system operator issues an EXEC 

command (DOS/VSE) or a START command (OS/VS) that names the ACF/VTAM 

procedure. The ACF/VTAM host-attachment routines are given control 

first. The start options specified for the system are examined, and 

these options are used to establish various operating characteristics 

for the ACF/VTAM network. ACF/VTAM modules are loaded into the parti- 
tion, storage is obtained for the ACF/VTAM communication vector table . 
(ATCVT) and the configuration table (CONFT), and these tables are 

initialized. The buffer pools controlled by ACF/VTAM's storage manage- 

ment routines are built, ACF/VTAM queues are initialized, and ACF/VTAM | ‘ 
files are opened. The ACF/VTAM initialization routines then attach sets | 

of ACF/VTAM routines as subtasks (or threads) under ACF/VTAM control. 
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Figure 1-2. Use of ACF/VTAM Components in Processing Macros and Commands 


In OS/VS, ACF/VTAM initialization may attach the following subtasks: 


@ Dump/load/restart, which dumps, loads, or restarts the NCP in a 
communications controller and performs other SSCP functions requir- 
ing task waits. 


e System definition, which maintains tables that define the character- 
istics and status of each network node... 


e TOLTEP, the Teleprocessing Online Test Executive Program. 


@ Tuning statistics, which collects data on the activity of each local 
programmable controller in the network. 

e ACF/VTAM termination, which ensures that resources allocated to 
ACF/VTAM application programs and to ACF/VTAM ccntrol blocks are 
returned to the operating system at abnormal termination. 


Licensed Materiai—Property of IBM 


Chapter 1. Overview of ACF/VTAM Operations 5 


SRR ADA eR TPT EP CO TER A Re EE FETE ET LOIN “LO te ISI IO ITI ETO I TIE EE TEI S BALI CO AMIE TEN TEE EO TE SEE LT PT OEE EEE EE LEI Ee EE I EE LO: IEE TEE TE EE eI ET RIE CME ERT TE TOE I IIE LIE TL TE BI IE OT OI OES TT aE ETE TET TE Tie A TT 


ACF/VTAM 


Figure 1-3. PLM Organization According to ACF/VTAM Components 
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In DOS/VSE, ACF/VTAM initialization can attach the following subtasks: 


e ACF/VTAM request processor, which handles asynchronous requests. 


6 Trace I/O, which prints the output of the trace thread. 


e TOLTEP, the Teleprocessing Online Test Executive Progras. 


_ ACF/VTAM initialization also creates the following ACF/VTAM threads: 


e Initialization, which pseudo-attaches the other threads. 


e System writer, which handles writing of messages to the systen 
console. | , 


e Operator control, which does initial processing of ACF/VTAMN 
commands. 


® Trace, which traces various events during ACF/VTAM processing. 


e Tuning statistics, which collects data on the activity of each local 
programmable controller in the network. 


® Dump/load/restart, which duaps, loads, or restarts the HCP in a 
communications controller and perforgs other SSCP functions requir- 
ing task waits. ; 


@ System definition, which builds or deletes tables that define the 
characteristics and status of each node in the domain. 


e Subtask completion, which attaches and detaches TOLTEP and detaches 
other ACF/VTAM subtask. 


After this processing has been completed, ACF/VTAM is ready to accept 
ACF/VTAM commands, which can be used to further define the network 
configuration. 


NETWORK CONFIGURATION DEFINITION 


After the system has been initialized, the parts of the network and the 
way in which these parts are connected to the system are established 
(see Figure 1-4). The configuration of the network and the characteris- 
tics of its nodes are represented to ACF/VTAM by a series of control 
blocks called resource definition table (RDT) seqments. Each RDT 


- segment represents a major node in the domain with which ACF/VTAM will 


communicate. A resource definition table segment is composed of a 
header and a number of entries. Each entry represents a specific 
(minor) node in the network. There are seven types of major nodes: 


Application program major node: An application program that can use 
ACF/VTAM is defined by an APPL statement. A group of application 
programs defined and named as a unit is an application ‘program major 
node. 


NCP major node: The specific nodes within the NCP major node are the 


lines, SNA ~ physical units, logical units, cluster control units, and 
devices that are attached to the NCP. 
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Note: The devices in the network and their relationship to each other are specified in the ACF/VTAM definition 
library (the source statement library data set in a DOS/VSE system and the SYS1.VTAMLST data set in an 
OS/VS system). An entry for each network element is included in the symbol resolution table (S RT) and 
in the resource definition table (RDT). Except for switched terminal sets, an entry for each major node is 
made in the major node table (MNT). A specific nade table is associated with each major node table entry. 
An entry for each device attached to the network through a communications controller, for each local © 

device, and for each application program is mace in the specie ealnor) node table (SNT) associated with 

the major node. 


Figure 1-4. Defining the Network Configuration 


Switched SNA major node: The specific nodes of a switched SNA major node 
are SNA physical units and logical units that can be attached to the © 
network earougn switched lines. | 


Local SNA najor node: The specific nodes of a local SNA = node are. 
the SNA physical and logical units attached to the data channel. 


Local Non-SNA major node: Sets of local non-SNA terminals are defined to. 


ACE/VTAM with LOCAL Statements. The individual devices are the specific 
nodes. A set of such specific nodes defined and ‘named aS a group is a 
local non-SNA major node. 


Cross-domain resource major node: One or more major nodes can be defined 
for cross-domain resources. Each major node represents a set of logical 
units in other domains that can be used for cross-domain communication; 
each minor node represents an application program or logical unit in 
another domain. 
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Defining the initial configuration of the network can be a step in the 
series of operations initiated by a start procedure. The nodes in the 
network can be initially defined to ACF/VTAM through the CONFIG option 
in the start procedure. The CONFIG option identifies a file (DOS/VSE) 
or data set (OS/VS) in which the ACF/VTAM major node names to be acti- 
vated are filed. These definition statements represent specific nodes 
* in the network. The specific node definition statements that are filed 
together as a book of a file (DOS/VSE) represent a major node. Ina 
multisystem network, communication paths can be defined as part of the 
initial configuration. 


file is read, and definition Statements are brought in and processed one 
at a time. The resource definition table (RDT) segments are built fron 
the ACF/VTAM definition statements by the system definition component 
and chained off a queue anchor block (QAB). | 


Building the Minor (Specific) Node Tables: In addition to the resource 
definition table, the system definition component builds the specific 
node tables (SNTs). These are addressing tables that are used during 
ACF/VTAM execution to locate resource definition table entries and other 
control blocks that describe the characteristics of specific addressable 
nodes within this host's domain. There is a specific node table entry 
for each device and application program entry in the RDT. RDT entries 
for switched terminal sets, cross-domain resources, and cross-domain 
resource managers are not included in the major or specific node tables. 
The SNT for application programs is built during initialization. Its 
size depends on the MAXAPPL start option value. 


ACF/VTAM configuration services routines activate and deactivate nodes 
in the network in response to operator commands and ACF/VTAM definition 
statements. They also perform automatic logon processing (that is, in 
addition to activating nodes, they allocate terminals to application 
programs). Once the initial system configuration has been specified, 
all the control blocks needed to process application program requests 
have been defined and initialized (see Figure 1-5). 


= _ Changing the Network's Configuration 


ACF/VTAM's system definition routines set up control information about 
the network in such a way that the user can change the contxguratson 
while ACF/VTAM is running. 


_ The configuration of the network is defined through the ACF/VTAM defini- 
tion statements. The configuration is changed when the network operator 
issues some form of the VARY command. The VARY command can also be 
issued by certain application programs. These application programs use 
ACF/VTAM's program operator interface. An application using the prograr 
operator interface can perform most of the functions of a network 
operator. 


ACF/VTAM does to change the network's configuration. The examples 


( | The remainder of this section contains a general description of what 
py 
selected represent some of the more typical processing sequences. 
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Figure 1-5. Control Block Structure after Initialization and - | a 
| Configuration Processing | . 


The VARY ACT Command: When the VARY ACT command is passed from the 
Operating system to ACF/VTAM, the command processor checks the syntax of 
the command; a code indicating that a node is to ve activated and the ID 
of the node to be activated are then placed in the network configuration 
services parameter list (NCSPL). The NCSPL is the work element for nost. 
ACF/VTAM operator commands. The request/response unit processing element 
(RUPE) is the work element for most other ACF/VTAM commands. Most 

of the processing of the VARY command is done by the system services | | : 
control point (SSCP) component. The SSCP first ensures that the _ - 
command is valid. Finding the command valid, the SSCP determines 

whether a resource definition table entry (RDTE) exists for the node. 

If no entry exists for the node, the system definition component | 

performs the same processing described earlier under "Initial Network ° 
Configuration Definition." After the RDT is built, entries exist for 
all the specific nodes (physical units, logical units, lines, applica- 
tion programs, cross-domain resource managers, etc.) in the major node. 
In addition to the RDT, control blocks such as the node control blocks, 
which describe characteristics of the nodes, and function management 
control blocks, which represent the sessions between the SSCP and the 
specific network nodes, are built. During activate processing, the SSCP 
activates the logical units when (1) the major node has been activated, 
(2) the links have been activated, and (3) the physical unit has been 
contacted and activated. 


Examples of this sequence are given in several of the figures in Chapter 5. 


Licensed Material—Property of 1BM 


16° 


eR ORE TIO ERE era YM SE RT EP, SY PME YE A BEM LEHI ETI ECO ORC OTE TS IE TEL MOE AE LE EAT ALTE TET A LILA EARN ELT NCEA EQ TN ERP EEE SY GET A EMME RIIENTSN 9° MOET SERMON ESTA ES A RED LOSE OPT EY PTS RN eR 2h 
= Aes No ea ee oe Re a oe BF Ned oak RY LE TS ee BE eee ee Behe ay args Cte eR Beaten pe ee Aw ag Sr keaton he Be ai os BigP age te Re Iie i Pa aia, aN bi SS aR NA ARIAL ARR IA LW cei oa 
Fs .* 7 . Raced é ae) x 2 3 “ + a oe Oe eG ad . L8G 2 . 7 


( 


f ve 

a i : 

_ : a * 
7? as 


IE EE TE Te TE a LE TRL: LESTER EIR TE AE SET STEEL ST Lt ST 


~ 


si eS a Doane tg 1.7 fai asi CS aan il ESRI Nc Sh iS seasaLiate tai Soa ses naan chin Eta he fash Sas SSE Sea Dn ie aR i te na can Tnt Lin sti tecuibina ithaca vines nase aa EESS Na a 


The process of activating a node establishes sessions between the 
physical and logical units and the SSCP. A session is a logical connec- 
tion between two addressable nodes that permits them to communicate with 
each other. Once a session is established between the SSCP and a 
logical unit, the SSCP aids in establishing and terminating sessions 
between that logical unit and other logical units. 


The VARY INACT Command: The VARY INACT command reverses the effects of 


the VARY ACT command. It ends the session that exists between the SSCP 
and the logical or physical unit specified by the ID parameter. 


One of two processing sequences occurs when VARY INACT is issued. If 
immediate deactivation was specified, the SSCP schedules the NSEXIT exit 
routine of the application program that is in session with the node 
being deactivated. If there is no NSEXIT routine, SSCP schedules the 
LOSTERM exit routine of the application program that is in session with 
the node being deactivated. Otherwise, if immediate deactivation was 
not specified, neither the NSEXIT nor the LOSTERM exit routine is 
scheduled. If the NSEXIT was not scheduled, the SSCP waits for the 
CLSDST macro instruction to be issued and for the session to be ternmi- 
nated by the OPEN/CLOSE component. After the session is terminated, the 
SSCP begins the deactivation sequence. This sequence ends the session 
between the SSCP and the node. The figures in Chapter 5 contain a 


_ @etailed description of these sequences for various types of major 


nodes. 


aiaiaainiees SESSIONS 


Sessions between logical units are established and terminated in 
response to session requests. The logical unit that sends the session- 
activation request (BIND) is the primary half of the session and the 
logical unit receiving the session-activation request is the secondary 
half of the session. More than one session between two applications in 
the same or different domains is allowed. Any of these multiple (paral- 
lel) sessions may be initiated by the primary or secondary half of the 
session (Figure 1-6). 


Before an application program can process I/O requests from another 
logical unit, three requirements must be met: 


1. At least one of the logical units must be an application progran 
that is known to ACF/VTAM. This knowledge is established as a 
result of an OPEN ACB macro instruction issued by the application 
progran. 


2.. The logical units must be in session with each other. The logical 

unit that is to be the primary end of the session must issue an 
OPNDST macro instruction before this session can be established. 
(If the secondary end of the session is an application program, the 
secondary end can initiate the session by issuing a REQSESS macro 
instruction.) To establish a session between two logical units, 
ACF/VTAM must set up pointers, build and initialize session- 
establishment control blocks, and complete the necessary inter- 
face. This process is called binding. Two separate aspects 
of binding are: 


® Establishing a communication path between the two logical units 


Selecting the ACF/VTAM routines needed to handle communication 
for these particular logical units 
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Note: A logical path to the logical unit (terminal) is allocated to the application program, 
and data can be transmitted between the application program and the logical unit. 


Figure 1-6. Establishing Connection between Application Programs and 
| . | Logical Units 


3. If the logical units are in different domains, a session between 
the cross-domain resource managers (CDRMs) of each domain must be 
established and the cross-domain resources must be defined before | 
the session can be established. © . 2 7 oo 


Establishing the Communication Path 


When an application program issues an OPNDST macro instruction regquest- 
ing a session with a logical unit that is not currently allocated to any 
other application program, ACF/VTAM's session-establishment routines 
allocate the logical unit to the application program. Except when the 
logical unit represents an application program, once a logical unit is 
allocated, requests for sessions with it are not honored until it 
becomes available. Those session requests must wait until the logical 
unit is released from its current allocation. The session-establishnent 
routines build the control blocks required for the session. Information re 
is obtained from the resource definition table (RDT) entries, the | | al 
request parameter list (RPL), and the access method control block (ACB) a 
to form a session information block (SIB). | here 
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Open destination routines then build the function management control 


oS block (FMCB), which associates the application program with the routines 
( needed to support the session. The FMCB enables the application program 
"Soe and the logical unit to communicate with each other. An FMCB is queued 


to the logical unit control block (LUCB) for the application program. 


Selecting ACF/VTAM Routines 


The other aspect of binding is determining which routines shall be used 
“ to handle communications for the particular logical units in the 
session. The determination is made by using a control block called the 
skeleton destination vector table (DVT). This control block contains an 
entry “for each routine that an application progres. can use for a 
* session. 


FMCBADD routines select those routines in the skeleton DVT that are 
required for this particular session, and then build a real DVT. The 
real DVT represents the routines to be used and the sequence in which 
they are to be executed. 


After the FMCBADD routines have selected the required entries from the 
skeleton DVT, they convert the symbolic addresses of the routine to the 
storage addresses that were assigned to the routines when they were 
loaded during initialization. A pointer to the real DVT is then placed 
in the process anchor block (PAB) within the FMCB, and the name of the 
real DVT is placed in the DVT entry point table (EPT). ACF/VTAM's 
process scheduling routines use the real DVT to schedule execution of 
the routines in the proper order. Figure 1-7 illustrates the construc- 
tion of a real DVT from a skeleton DVT. A skeleton DVT contains entries 
for required and optional processes. In the figure, the skeleton DVT 
contains required entries, which become the first and third entries in 
the real DVT. The skeleton DVT also contains a set of entries for three 
device-dependent routines. These routines perform equivalent functiofis 
for different types of logical units. The process that is necessary for 
the logical unit in the current session is selected and is then made the 
second entry in the real DVT. The skeleton DVT also contains another 
set of entries (two are shown) for device-dependent processes. The 
process that is needed for the logical unit (LU) in the current session 
is then selected and is made the fourth entry in the real DVT. The real 
DVT contains entries only for those processes that are needed to support 
a particular session. 


Binding includes sending a Bind RU to the secondary resource. When 
binding is completed, I/O requests from application programs can be 
accepted and processed (see Figure 1-8). 


PROCESSING 1/0 REQUESTS 


An I/O operation can be initiated at either end of the session. Two 
independent flows (one normal, the other expedited) are available for 
sending and receiving requests and responses. Data can flow in both 
directions simultaneously because logical units can simultaneously 
receive input and send output. The direction of data flow at any one 
time is governed by the type of line and the line control discipline. 
Therefore, at the session level, requests and responses may be inter- 
spersed. At the link level, requests and responses will be interspersed 
only on a duplex line. 
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Skeleton DVT | Real DVT 


Trainin id 


Note: When the real DVT is constructed from the skeleton DVT, only the processes e : 
required for communication with the terminal are selected. 


| Figure 1-7. Constructing a Real DVT from a Skeleton DVT 


After an application program and a logical unit establish a session, 
data can be transferred between them. ACF/VTAM I/O-request processing 


ben eed 


consists of two general types of processing:~ 


e Format conversion, which inserts control information within the 
requests so that requests sent to a particular type of logical unit 4 
are in the proper format and so that requests received from that | rs 
type of logical unit are handled properly. | 


Path control, which adds control information to the front of 
requests and responses so that they get to their destinations. 


Format Conversio 


Format conversion transforms information supplied to a logical unit 

into a request/response unit (RU), a request/response header (RH), and a 

transmission header (TH). Format conversion is done by the transmission = 
subsystem component (TSC) and builds a request unit suitable for the 

request unit's destination. Format conversion processing consists of: 


@ Routines that insert control information into the request so that it 
is handled properly or displayed properly after it reaches its. 
destination. The fundamental units of information in an SNA data 

communications system are request units and response units. Format 
conversion formats and attaches a control field (a request or 
response header) to the request or response unit. These control 
fields contain routing information, indications as to what type of 
response is desired (for example, respond only for error situation), 
and information as to whether a series of request units are related. 


e Routines that format the request and insert other internal control a 
information. 7 | an 
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Note: After an application program and a terminal have been connected, ACF/VTAM 
passes data received from the application program to the operating system’s !/O 
supervisor for transmission to the terminal. ACF/VTAM accepts input that the 
terminal sends to the 1/O supervisor and passes it to the application program. 
An application program can send data to and receive data from another 
application program with which it has established a session. 


a a j 
Regge gf 


Figure 1-8. Sending and Receiving Data 

Path Control 

Path control uses the information in the RH and TH to route a request or 

!response to its destination. Path control, which is done by the trans- 

;Mission subsystem component (TSC), consists of adding additional 

control information to the request to ensure that the request is handled 

properly as it passes through the network. A itransmission header is 

added when communicating with SNA terminals. The path control routines 

must handle requests for local terminals, as well as terminals attached 
( through the NCP. . 
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Qutbound Communication 


After the application program's I/0 request has been processed by TSC, 
it is passed by TSC to the host operating system's I/O supervisor, which 
then initiates the I/O operation. 


Inbound Communication 


Data sent from a logical unit to an application program is received by 
the host operating system's I/0 supervisor, which passes it to TSC. TSC 
then takes the data and passes it to the application program for which 
the data is intended. TSC then converts completion status information | 
to a form that is meaningful to an application program and passes it to “ 

the application program through the RPL. 


COMPONENTS THAT PERFORM I/0-REQUEST PROCESSING 


Two ACF/VTAM components perform the processing needed to convert an 
application program's I/0 request into a form that can be used by the 
operating syetes's I/O supervisor, that is, into a casane* program: — 
e The application program interface (APT) | 

e The transmission subsystem component fESC). 


The functions of eace of these ncomponents are summarized below. 


= 


Application Program- Interface (APTI) © | | | 2 


These routines process requests (issued as macro instructions) for 
session-establishment, session termination, and data transfer. fThe API 
routines filter both outbound and inbound information between the 
application program and other ACF/VTAM routines. For requests coming 
from application programs, the API checks whether the request is valid, 
interprets it, and passes it to the appropriate subcomponent. After the 
requested operation has been performed, the API routines notify the 
application program of its completion and provide the feedback (status 
Sneoreatlon) that resulted from the operation. ) 


Transmission Subsystem Component (ISC) — | | = | os 


The TSC is ACF/VTAM's interface with the operating system for outbound 
and inbound requests. The TSC receives an outbound request from the 
API, determines the type of request, ensures that it is a valid request, 
builds the appropriate channel program, and schedules it with the host 
operating system's I/O supervisor. The TSC receives an inbound request, 
response, or feedback from the I/O supervisor, and passes it to the API. 
When the TSC receives a request from a logical unit, if a RECEIVE 
request is not currently queued, the inbound request is queued. The 
request is sent to the application program only when it issues a RECEIVE 
request. 


Figure 1-9 illustrates how these components (API and TSC) transmit data _ ts 
from an application program and process the resulting feedback. \ 
Detailed examples of processing I/0 eae are in ACF/VTAM Execution 
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1The channel program consists of WRITE (output) and READ (input) CCWs. 


Figure 1-9. ,.Flow of Control and Data for I/O Requests 
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These macro instructions control data transfer between an application 
program and an SNA terminal: 


SEND: Causes ACF/VTAM to transmit a record or control information fron 
an application program to a logical unit. The four types of records 
that can be transmitted are application program data, application 
program response to data received, a control request, and a response to 
a control request. | : | 


RECEIVE: Causes ACF/VTAM to transfer a record or control information 
from an ACF/VTAM buffer to a storage area in the application prograr. 
RECEIVE may be limited to one type of Eeconee or it might handle all 
four types. | 


SESSIONC: Includes starting a transmission (Start Data Traffic), purging 
requests (Clear), resetting sequence numbers (STSN), requesting recovery 
(RQR), rejecting a Bind by a secondary end, and responding to an STSN or 
SDT received with the SCIP exit routine. 


RESETSR: Cancels pending RECEIVE request(s) and/or switches a logical 
unit's continue-specific mode or continue-any node. 


Before an I/O request can be issued, an RPL must be constructed that 
points to the opened ACB, contains information describing the type of 
I/O request, and contains a comamunication ID (CID). 


After a session has been set up, both nodes can start to send data 
immediately, provided that the session does not require a Start Data 
Traffic command. (If the session requires # Start Data Traffic command, 
neither node can send data oo the peansry end of the session issues 
the command.) 


Application programs transfer data by roe SEND and RECEIVE jeeea 
instructions. The flow of control and data that results from issuing 
.these macro instructions is illustrated in Figures 1-10 and 1-11. 


SEND 


This macro instruction requests that ACF/VTAM transfer a request or a 
response to a specific logical unit. An FID1 (Format ID=1) PIU speci- 
fies the format used for SNA terminals. Data is transferred from an 
area pointed to by the RPL; response information is specified -syaboli- 
cally in the RPL. Assuming that data is being sent from an application 
program, the TSC copies the data, builds a request header (RH) and 
transmission header (TH), formats channel command words (CCWs), and 
schedules the channel program. The transmission header contains infor- 
mation for routing the data through the network. If a response is 
necessary, the response from the logical unit is queued. When the 
application program issues a RECEIVE for the logical unit, the response 
is then passed to the application program. Figure 1-10 illustrates the 
processing of a SEND request. The example assumes that POST=SCHED was 
specified for the SEND. a | 
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Figure 1-10. Processing a SEND Request 
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Figure 1-11. Processing a RECEIVE Request 
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RECEIVE 


The RECEIVE macro instruction transfers data from internal ACF/VTAM 
buffers to the application program's input data area. RECEIVE can be 
issued in two formats: RECEIVE SPEC and RECEIVE ANY. RECEIVE SPEC 
requests data that was sent in by a specific logical unit, while RECEIVE 
ANY requests data that was sent in by any logical unit with which the 
application program is in session. 


The RECEIVE operation code is passed to ACF/VTAM in the RPL: 


e If data is available that will satisfy the RECEIVE request, the data 
is moved into the user's area. 


e If no data is available to satisfy the RECEIVE request and if the 
queue option was specified, the RPL is placed on a wait queue until 
data is received to satisfy it. 


e If no data is available to satisfy the RECEIVE request and the queue 
option was specified, RECEIVE will fail. 


A RECEIVE request does not cause any activity in the network. All 
processing takes place in ACF/VTAM. 


When the RECEIVE request is satisfied, the RPL is posted to indicate to 
the application program that the RPL can be reused. 


Figure 1-11 illustrates the processing of a RECEIVE ANY request. The 
example assumes that no data is available at the time the RECEIVE is 
issued, so the RECEIVE is gueued. Later, data arrives to satisfy the 
RECEIVE. | 
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In addition to initialization, network configuration definition, estab- 
lishing and terminating of sessions, and processing of I/O requests, 
ACF/VTAM also includes components that perform process scheduling 
services, storage management services, reliability, availability, and 
serviceability functions, termination, and multisystem networking 
functions. These components are described briefly below and in more 
detail in Part 2. 


Process scheduling services and storage management services provide 
ACF/VTAM with a means of requesting resources from the host operating 
system. Because these components interact with host operating system 
routines, they are system-dependent and vary from one operating systen 
to another. However, the services that they provide to other ACF/VTAM 
routines are independent of the host operating system. Since these 
routines act as a central facility for the services they provide, other 
components can request system services from this central facility and 
thereby remain independent of the operating systen. 


Process Scheduling Services (PSS) 


Process scheduling services (PSS) routines control the flow of requests 
through ACF/VTAM by scheduling and dispatching the routines needed to 
process requests from application programs. Because these routines 
serve as a dispatcher, ACF/VTAM does not need to use the operating 
system dispatcher to schedule its own work. 
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When an application program issues a request for a session or data ; 
transfer, the application program interface ensures that the request is aa 


valid and then issues a TPIO SVC. The TPIO SVC indicates to PSS that | a 4 
there is an application program request to be processed. In response to ) 


the TPIO SVC, system SVC handlers provide the change from problem- 
program state to supervisor state needed to process the request. 

PSS then schedules the request and a a the routines needed to 
process the request. 


To schedule the application program's request, PSS routines place the 
request parameter list (RPL) that represents the request on the appro- 
priate queue. Then, when the request is to be satisfied, ACF/VTAM 
routines find the RPL and do the processing needed to satisfy the 
request that it represents. _ 4 


To dispatch the routines needed to process the request, PSS routines - 
first select the real DVfs and any device-dependent routines required 

for the request. The routines named in the real DVT are then dispatched 

to process the application program's request. PSS routines transfer 

control from one DVT to another and from one routine pointed to by a DVT 

to another routine pointed to by the same DVT. See "Scheduling an 

ACF/VTAM Process" in Chapter 2. 


ACF/VTAM's storage management routines operate with host operating 
system storage management routines to provide ACF/VTAM components with 
storage areas for control blocks and I/O buffers. Storage management 
services are not directly available to application programs, but only to 
ACF/VTAM components, which, in turn, perform the following services for 
the application programs: a 


e Building pools for buffers (either pageable or ponpagesdie)s and _ ‘ 
variable-length storage areas 


e Expanding and contracting buffer pools 
e Allocating and releasing buffers | 


ACF/VTAM components issue the following | macro. instructions to eequest 
storage management services: 


e BLDPOOL macro instruction, which is used during initialization to 
build a buffer pool and make an entry in the pool directory 


e DELPOOL macro instruction, which is used during termination to _ = 
delete a buffer pool from the system and remove its entry from the | 
pool directory 


® GETSTOR macro instruction, which requests variable-length storage 
from the appropriate storage area 


e §FREESTOR macro instruction, which releases storage obtained by 
GETSTOR and makes it available for reallocation | 


e REQSTORE macro instruction, which makes requests for fixed-length 
buffers to be used to hold data or control block information 


e RELSTORE macro instruction, which releases a buffer, or a chain of 
buffers, previously acquired through the REQSTORE macro instruction oe 
| oo 


e VTALLOC macro instruction, which requests variable-length storage ay 
from the appropriate storage area 
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® VTFREE macro instruction, which releases storage obtained by VTALLOC 
and makes it available for reallocation 


Reliability, Availability, and Serviceability (RAS) 


ACF/VTAM can trace the I/0 activity of any addressable node and can also 
trace the contents of buffers as they enter and leave ACF/VTAM control. 
The ACF/VTAM internal trace keeps a record of ACF/VTAM resource usage 
and flow of control. 


Reconfiguring the Network Dynamically 


Dynamic reconfiguration (DR) allows ACF/VTAM to add and delete cluster 
control units and their associated logical units to or from nonswitched 
links without the need to do a new NCP generation. This allows the 
physical relocation of PUs and LUs temporarily until the clusters have 
been returned to their original configuration or, in the case of a. 
permanent move, a new NCP can be generated. 


All PUs are added to or deleted from the physical unit dynamic recon- 
figuration pool (PUDRPOOL) and all LUs are added to or deleted from the 
logical unit dynamic reconfiguration pool (LUDRPOOL). The DR function 
is provided through the VARY command by requesting the addition or 
deletion of control records and resource definition statements in the 
dynamic reconfiguration data set (DRDS). 


Shutting Down the Network ~ 


To shut down the network, the network operator issues a HALT command, 
which invokes ACF/VTAM's termination routines. These routines perform 
operations that are the reverse of those performed by the initialization 
routines. The termination routines delete the ACF/VTAM modules and free 
all system resources acquired for ACF/VTAM. Control is then returned to 


the operating systenr. ; 


A 
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CHAPTER 2. ACF/VTAM CONTROL BLOCKS 


A general understanding of the nost-used control blocks is needed to 
7 understand the overall operation of ACF/VTAM. These control blocks can 
| be grouped into the following categories: 


ie e Configuration control blocks, which define the components and 
structure of the domain 


e ACF/VTAM-application program interface control blocks, which permit 
_* application programs to use ACF/VTAM facilities 


e Session control-blocks, which describe sessions between logical 
* .. tUnits 


® Process scheduling control blocks, which are used in scheduling and 
processing I/0 requests 


The control blocks in these groups are described in the following 
sections. For more details about individual control blocks, refer to 


CONFIGURATION CONTROL BLOCKS 


SpE cea 


Gontrol blocks that define the ACF/VTAM configuration are: 


e ACF/YTAM communication vector table (ATCVT) 


e Boundary function table (BFT) 


@ Intelligent controller node control block (ICNCB) 


7 e Local device node control block (LDNCB) 
od e Resource definition table (RDT) 

e@  ~=©Symbol resolution table (SRT). 

o “Major node table (MNT) 

e Specific (minor) node table (SNT) 


' The relationship of these control blocks is shown in Figure 2-1. 
ACF/VTAM COMMUNICATION VECTOR TABLE (ATCVT) 


The ATCVT contains the addresses of routines that are not contained in 
destination vector tables (DVTs). The ATCVT also contains the addresses 

of other control blocks (such as the resource definition table and 
symbol resolution table) that are needed for ACF/VTAM execution. 


BCUNDARY FUNCTION TABLE (BFT) 


Cy The BFT is used for path control and transmission control functions for 
a logical units and physical units connected to ACF/VTAM through a locally 
attached SNA cluster controller. There is one BFT for each cluster 
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controller, and one BFT entry for the physical unit and for each logical | 
unit attached to that physical unit. | | joes 


The BFT entry for a logical unit contains information that enables oa) 
ACF/VTAM to maintain the status of each session flowing through the 
boundary function and to maintain information needed to support pacing. 


System Communications Vector. : | . ; 
Table (CVT) — OS/VS or . 
System Common (SYSCOM) DOS/VS 


Address Vector —— | 


a ne 


Queue Anchor Block (QAB) 


ACF/VTAM Communication 
Vector Table (ATCVT) 


w 


Resource | 
. Definition on 
Table (ROT) u 


‘Symbol Resolution 
Table (SRT) 


ROT Entry 


|. ROT Entry 


Major Node 
Table (MNT) 


_ Specific (Minor) Node 
- Table (SNT) 


Figure 2-1. Tables That Define the Configuration of an ACF/VTAM Network 
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INTELLIGENT CONTROLLER NODE CONTROL BLOCK (ICNCB) 


The ICNCB is ACF/VTAM's representation of a channel-attached physical 
unit. The ICNCB is created when the physical unit is activated under 
ACF/VTAM control (that is, when the operator issues a VARY ACT command). 
The ICNCB defines the characteristics and current status of the physical 
unit. This information is needed by ACF/VTAM to control I/O initiation 
and termination. It also defines scheduling queues and parameters 
reguired for communication with the I/O supervisor routines that actual- 
ly perform the I/O operation. 


LOCAL DEVICE NODE CONTROL BLOCK (LDNCB) 


The LDNCB is ACF/VTAM's representation of a local non-SNA terminal. The 
LDNCB defines the characteristics and current status of the terminal. 
This information is needed by ACF/VTAM to control I/0 initiation and 
termination for the terminal. It also defines scheduling queues and 
parameters required for communication with the I/0 supervisor routines 
that actually perform the I/O operation. The LDNCB is created when the 
Operator issues a VARY ACT command for the terminal. 


RESOURCE DEFINITION TABLE (RDT) 


The RDT describes the resources available to the system. It contains 
entries for communications controllers, groups, lines, cluster control 
units, terninals, terminal components, logical units, physical units, 
cross-domain resources, cross-domain resource managers, and application 

programs. The resource definition table is a segmented table: each 
segment contains information about a major node defined during system 
definition. A major node consists of a communications controller ang 
its attached terminals, a group of local non-SNA terminals, a group of 
Fhysical and logical units attached through the switched network, a 
group of physical and logical units attached through a data channel, a 
group of cross-domain resources, a group of cross-domain resource 
Managers, Or a group of application programs. Reference is made to 
these major node subcomponents during ACF/VTAM startup and during 
OPEN/CLOSE, VARY, MODIFY, and DISPLAY processing. Figure 2-2 illus- 
trates the format of the RDT and the node entries for a communications 
controller's NCP. The RDT consists of a chain of RDT segments that 
represent comgunications controllers, lines, cluster control units, and 
devices. Each 3705 communications controller is defined as a separate 
segment. (See Figure 2-3.) 


A description of the RDT segment header and the various parts of the RDT 
segment follows: | 


RDT Segment Header: Each RDT segment is preceded by a header that 
identifies whether this RDT segment applies to an application progran 
major node, an NCP major node, a switched SNA major node, a local SNA 
major node, a local non-SNA major node, a CDRM major node, or a CDRSC 
Bajor node. The header is also used to chain the RDT segments together. 


APPL Entry: The APPL entry appears in the application program RDT 


segment. It defines a particular application prograa. 


CDRM Entry: The CDRH entry appears in the CDRM RDT segment. It defines 
either the cross-domain resource manager for this domain or the 
cross-domain resource manager for another domain. 
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Figure 2-2. Resource Definition Table (RDT), Showing Node Entries 
for a Communications Controller NCP 


Licensed Material—Property of IBM 


28 


eos a aI a i eS ie Rane eee eee Eee Eee ONT ee ee LT OI Re ARR CEG Cn on pr oa pe praesent oe ae een ane hp phe or ae ay YET SOT CTO ATOM ED PCT STEN TE RR ROCEP TOSCO NSN OCR NEG RTA HH 
wt SAT aN aad acai ia al ala ECD See ee Ea ee ee ee pe ee Pee oe Sa SS Se eee Se SO a 3 ? Ee ere ee a er see sera LOR LTP NGS INE " 
: ; ‘ r . 7 ane s al os : en Ca ote ae ; Hee a Te, Oe ee ee . : whe cide TR ae Egor ge : : 4 = 43 s 


fee PRESS in Peete TN Ne Paw, Dahle Cosette ete 


(28 Ten eR AAA ASIN is SE PIES TS tA 


| NCP RDT Local SNA Local Non-SNA 
( Segment RDT Segment RDT Segment 


GROUP 
LINE 


CDRSC 
RDT Segment 


LINE 


Switched SNA — | | _ Application Program 
ROT Segment *” RDT Segment 


CDRM 
ROT Segment 


| LINE , 
PUX 
LUX 


Figure 2-3. Structure of RDT Segments 


CDRSC Entry: The CDRSC entry appears in the CDRSC RDT segment. It 
7 defines a particular cross-domain resource. A cross-domain resource is. 
. a logical unit in another domain with which logical units in this domain 
can communicate. 


Channel Attachment Entry (DAN): The DAN entry appears in the local SNA 
and local non-SNA RDT segments. It defines a channel attachment to the 
host processor. There is one DAN entry for every channel-attached 
device defined in the major node. In a local SNA RDT segment, each DAN ~~ 
entry is followed by a PU entry.. In a local non-SNA RDT segment, each 
DAN entry is followed by a single LU entry. | 


wr GROUP Entry: The GROUP entry appears in the NCP RDT segment. It defines 
(ams: . a group of switched or nonswitched lines. Switched and nonswitched 
a lines cannot appear together in the same GROUP. Each GROUP entry is 

fe followed by one or more LINE entries. 
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LINE Entry: The LINE entry appears in the NCP RDT segment. It defines a 
particular switched or nonswitched line. Each LINE entry is followed by 
one or more PU, PUX, or RIN entries. PU, PUX, and RIN entries cannot be 
mixed together on the same LINE. : 


LU Entry: The LU entry appears in the NCP, switched SNA, local SNA, and 
local non-SNA RDT segments. It defines a logical unit. 


LUX Entry: The LUX entry appears in the NCP RDT segment. It defines a 
network address for a switched-network logical unit. | 


PU Entry: The PU entry appears in the NCP, switched SNA, local SNA, and 
RDT segments. . It defines a physical unit. Each PU entry is followed by 
one or more LU entries. | | 


PUX Entry: The PUX entry appears in the NCP RDT segment. It defines a 
network address for a switched-network physical unit. When a switched- 
network connection is made between the physical unit and ACF/VTAM, the 
PUX is associated with a PU entry in the switched SNA major node. 


RIN Entry: The RIN entry appears in the NCP RDT segment. It defines a 
cross-subarea link station. 


SYMBOL RESOLUTION TABLE (SRT) 


The symbol resolution table (SRT) is used to convert the symbolic nane > 
of a node or table into the address of the node or table. The SRT is 
used most often for opening and closing the I/O interface between an 
application program node and a ges ernecton ngde,. and for displaying ane: 
altering the status of. nodes. 


The SRT, illustrated in Figure 2-4, is a multilevel table created during 
the activation process (by VARY ACT) and during ACF/VTAM initialization. 


The first level is the SRT directory (SRTD), which contains the addresses 


of the beginning of the SRT entry queues. There are 1023 such 

queues. Whenever ACF/VTAM creates an SRT entry, it applies an algorithn 
to the name field of the SRT entry to randomly allocate the SRT entry to 
one of the SRT queues. When ACF/VTAM has to find the SRT entry associ- 


ated with a given name, it uses the same i a to find the SPPEOPED= 


ate SRT gueue to search. 


The SRT contains an entry for each symbolic node name that is known to 
ACF/VTAM. Entries are included for all nodes defined in an active NCP 
major node, all application programs, all cross-domain resources 
(CDRSCs), all cross-domain resource managers (CDRMs), and all local 
devices that are defined to ACF/VTAM. Entries are also included for all 
USS definition tables, all logon mode tables, and all interpret tables. 
SRT entries exist for all nodes, not just for addressable nodes. 
Nonaddressable nodes include lines, line groups, and the nogscas, units 
and physical units in switched SNA major nodes. | 


there are four types of SRT entries: those that are part of an RDT 
entry, those that point to an RDT entry, those that point to a table, 
and those that point to the RDT entry of an application program that is 
to receive a network services request unit. Within the SRT entry is a 
type field that indicates which type it is. Each SRT entry also has a 
name field that corresponds to the name of the associated node. 
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Figure 2-4. Symbol Resolution Table (SRT) 
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Every RDT entry begins with an SRT entry. Therefore, every RDT entry 
can be found through the SRT directory by use of the appropriate node 
name. For example, when ACF/VTAM needs to find the RDT entry for a 
legical unit named LOGUNITS5, it runs this name through the algoritha to 
find the appropriate SRT queue. ACF/VTAM then searches each SRT entry 
on that queue until it finds the SRT entry whose name field contains 7 a 
LOGUNIT5. ACF/VTAM also checks the type field to ensure that what it -* 
has found is really an RDT entry and not a table by the same name. The Mo 
RDT entry for that logical unit immediately follows the SRT entry. 


Additional SRT entries can exist that point to the RDT entry, but are 
not part of the RDT. These additional SRT entries are used for the 
physical units in switched SNA major nodes. When a session is estab- 
lished with such a physical unit, the physical unit’ provides an exchange 
ID (XID). ACF/VTAM builds an SRT entry with the XID in the name field 
and chains this SRT entry to the SRT entry for the physical unit name. 

Therefore, the RDT entry for a switched physical unit can be found 

either through the physical unit name or through the XID supplied by the 

physical unit. 


SRT entries can also point to a table. This table can be a USS defini- 
tion table, a logon mode table, a CSMI routing table, or an interpret 
table. ACF/VTAM locates the table, using the name of the table and the 
SRT directory, in the same way as it locates an RDT entry. 


SRT entries are also used to route a network services request unit. An. 
application program can be authorized to receive certain network services 
request units. When ACF/VTAM processes the definition statements 

that indicate which application programs are to receive each of these 
request units, ACF/VTAM builds an SRT entry for each request unit that 
has the request unit identifier in the name field and points this SRT 
entry to the RDT entry for the application program name. Should os 
ACF/VTAM receive such a network services request unit, it searches the : eee 
SRT for a matching entry. If such an entry exists, it points to the 4 
application program that is to receive this request unit. If the entry 

does not exist, ACF/VTAM discards the request unit. 


MAJOR NODE TABLE (MNT) AND SPECIFIC NODE TABLE (ST) 


The MNT and the base portion of the SNT are built during ACF/VTAM 
initialization. The MNT contains entries for each subarea in the 
network (as specified by the MAXSUBA parameter). The SNT contains 
entries for each specific node within a major node that can be addressed 
in the domain. However, the SNT does not. contain entries for logical 
units and physical units in switched major nodes, because they are not 
supported as addressable nodes; nor do they contain entries for specific 
nodes in other domains, because their addresses are not known in this 
domain until a session is established with them. Although the address- 
ing tables are built during initialization or when a VARY ACT command is 
issued for a node, they are updated when an application program issues 
an OPNDST macro instruction for the particular node. Figure 2-5 shows 
the node addressing table structure. 


The node addressing tables are used to match the destination address 
portion of a communication address with the address of an internal 
control block that represents the destination node. The node addressing 
tables serve as a directory of all destination addresses for which one 
or more I/O interfaces exist. 
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1 Before OPN DST, this field contains the address of an RDTE. 
Before OPEN for the application program, this field contains the 
address of an application program RDTE. | 


Figure 2-5. Node Addressing Table Structure 


The following control blocks define the interface between ACF/VTAM and 
. application programs: 


a Access method control block (ACB) 
“ ACF/VTAM data extent block (ACDEB) 
e Asynchronous process table (APT) 

e Logical unit control block (LUCB) 


The relationship of these control blocks is shown in Figure 2-6. 
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ACCESS METHOD CONTROL BLOCK (ACB) 


( ‘ The ACB represents an application program to ACF/VTAM. The ACB is 

oe initialized in response to an application program's OPEN ACB request. 
The ACB is a part of the user's application program; it defines the 
interface between the problem state application program code (generated 
Ay by macro instructions in the application program) and the supervisor 

( . state ACF/VTAM routines that support the application program. Once this 
RO interface has been established, the application program has access to 
such system facilities as destination open and close and the I/O inter= 
face routines. 


ACF/VTAM DATA EXTENT BLOCK (ACDEB) 


The ACDEB contains information needed by ACF/VTAM to service application 
program requests. For example, the ACDEB provides the application 
program with information needed for scheduling the open destination and 
close destination operations, which are performed in supervisor state. 
The ACDEB also provides the reguired information for special formas of 
I/O requests. 


_ACF/VTAM control blocks that represent the application program's. associ- 
‘ation with ACF/VTAM routines are chained off the ACDEB, which serves as 
an anchor point for request-processing operations. The ACDEB also 
serves as the control point for terminating sessions when an application 
program is terminated abnormally or issues a CLOSE ACB macro instruction 
while sessions still exist. 


oa _ . Cail 


ASYNCHRONOUS PROCESS TABLE (APT) 


The APT is ACF/VTAM's representation of an application prograa's task’ 
This control block serves as the control point for scheduling all 
asynchronous functions related to the application program. These 
functions include scheduling T/0-request | processing, completion process- 
ing, session-request completion processing, and asynchronous user exit 
routines. 


LOGICAL UNIT CONTROL BLOCK (LUCB) 


ae The LUCB is ACF/VTAM's representation of an active application program. 
- There is one LUCB for each active application program. Chained off the 
application program's LUCB are the FMCBs that represent the other half 
of the application program's active sessions. The LUCB is created when 
the application program is activated by OPEN ACB processing and is 
° | deleted by CLOSE ACB processing. After the LUCB is created, its address 
is placed in the specific node table. 


The size of the LUCB depends on the value specified for the EAS paraae- 
ter in the APPL statement that defines the application program. The EAS 
parameter specifies the greatest number of active sessions that the 
application program is expected to have at any one time. 


The content of the LUCB also depends on the EAS value specified. If the 

EAS value is small, the application program is represented by an LUCB 
ao that contains an entry for each active session. These entries consist 
oo. of the 2-byte address of the logical unit and the 3-byte address of the 
Poe associated FMCB. In this case, the FMCB is found by searching the 

entries in the LUCB for one whose network address matches the one for 
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the specified node. If the EAS value is not specified or is large, the 
LUCB contains pointers to rows of FMCB look-up table entries. A special 
algorithm is used to add, peter se and find entries in the FMCB look-up 
table. 


SESSION 


AED ERIS RE SEED 


Q 


ONTROL BLOCKS 


Several control blocks support four fundamental types of session: 
e SSCP-SSCP sessions | | | 

® SSCP-PU sessions 

@ SSCP-LU sessions 

° LU-LU sessions 


For the most part, the same types of control blocks are used for all 
four types of sessions. These control blocks are: 


e Session information block (SIB) 
e Function management control block (FMCB) 
e Node identification block (NIB) 


The relationship of these control blocks is shown in Figures 2-7 and 
2-8. 


t 


SESSION INFORMATION BLOCK (SIB) 


The SIB indicates the status of an LU-LU session. SIBs are used by the 
session services subcomponent of the SSCP to keep track of which 
sessions exist and how far session establishment or termination has 
proceeded for a particular session. One SIB is created for every 
session request received by ACF/VTAM. | | | 


Each RDTE has two SIB queues: one for SIBs that represent sessions in 

which the logical unit is the primary end and another for SIBs that 

represent sessions in which the logical unit is the secondary end. 

Therefore, each SIB is queued off two RDTEs, one of which represents the 

primary end and the other the secondary end. The SIB contains pointers 
to the RDTEs for both logical units participating - in the session. 


To find all the sessions in which a logical unit is participating, one 
examines both SIB gueues that are associated with the logical unit's 
RDTE. This reveals not only the active sessions (those for which OPNDST 
or OPNSEC has completed), but also the pending active sessions (those 
for which the logon exit has been scheduled, but for which the session 
has not been established) and the queued sessions (those for which the 
logon exit has not been scheduled). The SIB indicates whether the 
session is active, pending active, or queued. 


FUNCTION MANAGEMENT CONTROL BLOCK (FMCB) 


The FMCB is ACF/VTAM‘s representation of a half-session. The FMCB is 
associated with the application program by an LUCB, which contains 
pointers to FMCBs representing sessions with the application prograa. 
The FMCB contains the address of the ACDEB. 
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Figure 2-7. Control Blocks That Represent a Session 
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Figure 2-8. Control Blocks That Represent Sessions for 
— Local Devices | 

The major contents of the FMCB are the queue anchors to which requests | - 

and responses (including data) are queued, the destination vector table 

(LVT) addresses that define the processing routines that were selected 

at session establishment, and the status of the half-session that this. | 

FMCB represents. : ? . 

The major users of the FMCB are the TSC and process scheduling routines. 

NODE IDENTIFICATION BLOCK (NIB) 

The NIB describes the characteristics of a session request and identi- 

fies the logical unit for which the session is to be established or 

terminated. - 
Ne 
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PROGRAM OPERATOR CONTROL BLOCKS 


The following control blocks are used for the interface between ACF /VTAM 
and a program operator application progran: 


pe: e § Program operator control block (POCB) 
( e Program operator message header (POHD) 
e Program operator interface area (POTA) 
e Program operator message control block (POMCB) 
e Program operator parameter work area (POPWA) 
e Program operator reply control block (PORCB) 
e Program operator work element (POWE) 


The relationship of program operator control blocks ‘is shown in Figure 
2-9. | 


Program Operator Control Block (POCB): The POCB is the primary prograr 
operator control block. It represents an application program in session 
with the program operator interface (POI). Each POCB serves as an 
anchor point for all control blocks dealing with messages to be received 
(POMCBs) and replies to be sent (EORCES) by that application progtes: 


Prograa Operator Message Header (POHD): The POHD is the header associ- 
ated with each command sept by ACF/VTAM to the program operator ané@ each 
message received by ACF/VTAM from the program operator. The POHD is 
used for message association in the program operator application 
progran. 
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| Figure 2-9. Relationship of Program Operator Control Blocks 
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Program Operator Interface Area (POIA): The POIA acts as an anchor block 
for the program operator ‘control block (POCB) chain and the progran 
operator interface (POI). 


Program Operator Message Control Block (ROMCB) : The POMCB contains a 


message generated ~ by ACF/VTAM t to be - passed to the program operator 
application program. 


Program Operator Parameter Work Area (POPWA): The POPWA is a data area 


used by the program operator r interface (POI) to pick out command Or 
reply text and do initial validation. 


Program Operator Reply Control Block (PORCB): The PORCB represents 
ACF/VTAM waiting for a reply. to a WTOR macro instruction. 


Program Operator Work Element (POWE): The POWE represents a WTO or WTOR 
macro instruction issued by ACF/VTAM to a program operator. A POMCB 


and, if necessary, a PORCB are built from the POWE. 


PROCESS SCHEDULING CONTROL BLOCKS 

The following control blocks are used in scheduling and ene 
ACF/VTAM processes: | | 

-e@ Process anchor block (PAB) 

x2 Skeleton destination vector table (skeleton DVT or SDVT) 
@ Destination vector table (DVT) 

e Request parameter header (RPH) 

e Lock queue anchor block (LQAB) 

© Network address block (NAB) 

e Waiting request element (WRE) 

Control blocks that contain PABS are the: 

o- Asynchronous processing table (APT). 

e ACF/VTAM data extent block (ACDEB) 

e ACF/VTAM communication vector table (aTcvt) 

® Dynamic process anchor block (DYPAB) 

* Function management control block (FMCB) 

e Logical unit control block (LUCB) 

e Node control. block (NCB) 

e User exit control block (UECB) 

Work elements queued to PABs are the: 

°  Dump/Load/Restart Parameter List (DLRPL) 

® Network configuration services parameter list (NCSPL) 


® Pool control block (PCB) 
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e Program operator work element (POWE) 

(> e Request parameter list (RPL) 

| e Request/response unit processing element (RUPE) 
e TOLTEP interface element (TIE) 

( ® Trace record (TRAC) 

® Trace parameter list (TRCPL) 

° Transmission subsystem control block (TSCB) 

® User exit control block (UECB) 


Process Anchor Block (PAB): Process anchor blocks are dispatching points 
for process scheduling services (PSS); for example, a PAB may be sched- 
uled to cause execution of the modules addressed by the DVT associated 
with the PAB. A PAB may be explicitly scheduled with no work elements, 
or a work element may be queued to a PAB to cause it to be scheduled. 
PABs are not stand-alone control blocks; they are always contained 
within another control block. 


Skeleton Destination Vector Table (Skeleton DVT): The skeleton DVT 
contains a list of all routines needed to support a session. Routines 
hamed in a skeleton DVT are marked either as unconditional (always 
needed) or as conditional (for example, routines used only for a parti- 
cular type of session). A real DVT is constructed from a skeleton DVT 
by selecting those routines needed for each session. 


Destination Vector Table (SVT): The DVT is not a control block in tHe 
usual sense. Rather, it is a parameter list for the ACF/VTAM execution 
sequence controller. A DVT lists, in the order they are to be executed, 
the addresses of the routines that must be executed to pass a request, to 
the specified destination. The execution sequence controller uses thé 
DVT to determine the routine that should next be given control sneneree 
execution (of a preceding routine is completed. 


( | 
a. 


Request Parameter Header (RPH) : The RPH is an internal parameter list 
and work area created by process scheduling routines. It contains the 
address of a queued work request element that is ready to be scheduled 
and other parameters necessary to define the processing environment for 
the routines that service the request. 


Lock Queue Anchor Block (LQAB): The LQAB is the anchor for a queue of 
Waiting request st elements (WRES) and network address blocks (NABs) . 


Network Address Bloek (NAB): The network address block (NAB) is used to 
find the RDTE for a resource, given the network address of the resource. 
Each NAB contains a network address and a pointer to the RDTE for the 
resource associated with that network address. A queue of NABs is 
searched until the NAB containing the required network address is found; 
then the location of RDTE is obtained from the NAB. With parallel 
sessions, there can be multiple network addresses fora network resource 
and, therefore, multiple NABs for that resource's RDTE. 


Waiting Request Element (WRE): A WRE represents an ACF/VTAM process that 
is waiting for the completion of an event after having issued a CPWAIT 
macro instruction. WREs are queued to the LQAB specified in the CPWAIT 
macro instruction. When a CPPOST is issued for the event, the WRE is 
dequeued, and the waiting process is resumed, if appropriate. 
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Major Control Blocks 

f _ 
Major control blocks in ACF/VTAM are defined as control blocks that : | ay 
contain PABs. See the heading "PABs Used by Major Control Blocks" for a | 
list of the major control blocks, the PABs they contain, and the work 
elements associated with the PABs. | | | aa 


Asynchronous Process Table (APT): This control block, discussed under 
the heading "ACF/VTAM-to-Application Program Interface Control Blocks," 
is also an important processing control block. It serves as the control 
point for scheduling all asynchronous functions related to an ACF/VTAM 


application progran. 


ACP/VTAM Data Extent Block (ACDEB): The ACDEB, discussed under the 


heading WACF/VTAM~to-Application Program Interface Control Blocks," - 
contains the RECEIVE ANY PAB and the system service PAB. 


the headin ~ *Configuration Control Biccks{«" contains several PABs, as 
shown under "PABs Used by Major Control Blocks." 


Dynamic Process ‘Anchor Block (DYPAB): The DYPAB is a control block. used 
to contain a PAB that would not otherwise reside within a major control 
block. It contains a header and a PAB used to schedule an ACF/VTAM 


process. 


Function Management Control Block (FMCB): The FMCB, discussed under the 
heading» "Session Control Blocks," contains inbound ane outbound TSsc 
PABs. ! 


Logical Unit Control Block (LUCB): The ‘LUCB, “Tiscussed under the heading 
"Session Control, Blocks," is also used in process scheduling. 


Node Control Block (NCB): The LDNCB and the ICNCB, discussed under the 4 


heading "Se "Session Control Blocks," each contain a path control routing ! 
PAB, a PU services PAB, and a utility function PAB for TSC. pe eae 
User Exit Control Block (UECB): The UECB is both a major control block & Nee 


and a work element. It contains the PAB used to schedule the user exit 
routine, and it is the work element that defines input to the user exit 
routine. 


Dump/Load/Restart Parameter List (DLRPL): The DLRPL contains the parame- 
ters used by certain modules of the dump/load/restart thread. 


Network Configuration Services Parameter List (NCSPL) : The NCSPL repre- . 


sents an ACF/VTAM command ~ (such a as ~ VARY) that is being processed. The 
NCSPL contains the symbolic name of the resource (the RDT entry) and the 
address of a storage area used both as a save area and working storage. 
The NCSPL reflects the status of processing for the command and is used 

to store status information when processing of the command is interrupted. 


Pool Control Block (PCB): This control block describes the ACF/VTAM 
buffer pools and serves as the anchor for a queue of unallocated 


buffers. 

Program Qperator Work Element (POWE): The POWE represents a WTO or WTOR _ 
macro instruction issued by ACF/VTAM to the program operator. It is the ae 
work element for the program operator interface. : ae. 
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e Indicates (with a node initialization block [NIB] pointer) the nodes 
that are to be put in session with the application program when an 
OPNDST is issued or (with the communication ID [CID]) the node that 
is to receive data when output requests are made, and from which 
data is to be obtained when input requests are made. 


e Indicates the location and length of data supplied by the applica- 
tion program for output requests, and indicates the location, 
maximum possible length, and length of data actually received 
following an input request. 


e Indicates the location of the ECB to be posted by ACF/VTAM and 
checked by the application program after an I/O request, or, alter- 
natively, indicates an exit routine to receive control when the ECB 
would otherwise have been posted. 


e Indicates which attributes of an I/O request are to be in effect 
(for example, processing is synchronous rather than asynchronous, or 
output requests are automatically followed by input requests). 


An RPL can be created during assembly with the RPL macro instruction, or 
it can be created during execution with the GENCB macro instruction. | 
Except for indicating the CID, the functions listed above are controlled 
by the application program through the operands of the RPL macro 
instruction. 


Request/Response Unit Processing Element (RUPE): The RUPE is the major 
work element for ACF/VTAM mainly in configuration services, logical unit 
services, and PSS. It is the work element for request/response unit 
processing and contains the information needed to process an RU. 


TOLTEP Interface Element (TIE): The TIE is the work element for intery 
facing with TOLTEP. It contains a request code that indicates the 
function to be performed. 


Trace Record (TRAC): The TRAC is the record that the trace writer is to 
write on the trace file. 


type of trace and the node affected. 


race Parameter List (TRCPL): The TRCPL contains flags that indicate the 


Transmission Subsystem Control Block (ISCB): The TSCB is the work 
element for TSC inbound and outbound processing. | 


User Exit Control Block (UECB): The UECB is both a major control block 
and a work element for the user exit routine. | 


Scheduling an ACF/VTAM Process 


An ACF/VTAM process is a unit of work done by a group of routines to 
satisfy, or partially satisfy, a request from an application progran, 
the network operator, the network (for example, a cross-domain or USS 
logon request), or-an ACF/VTAM component. The request is represented by 
a control block that is designated as the work element. See Figure 2-10 
for an illustration of the control blocks used to schedule a process. 
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OS/VS PST | DOS/VSE APT 


RPH 


PAB — 


Work Element 


DVT 
Pointers — 
to 
Routines 
IST xxxxx 
ISTyyyyy 
iSTzzzzz 
Work Elements : 
| RPL NCSPL — RUPE . ee. TSCB —. DLRPL 
For | . For | | 
| RECEIVE | For | Processing [| 
Request For Request 
ENG VARY SReIRUI through : 
| 4 Command bee the TSC 
Request Processing | 
from an component | 
| Application 


Program _| 
Figure 2-10. Control Blocks Used to Schedule a Process 


For example, a request parameter list (RPL) could represent a RECEIVE 
reguest from an application program, a network configuration services | 
parameter list (NCSPL) could represent a VARY command from the network 
operator, or a transmission subsystem component block (TSCB) could 
represent a SEND request from the SSCP to the TSC. 


A work element is normally passed from one component to another by 
queuing it to a process anchor block (PAB). The process anchor block is 
a control block that represents a specific set of routines. In the 
process anchor block there is a pointer to a table that contains the 
addresses of these routines. This table is called the destination 
vector table (DVT). Consequently, the first step in preparing a work 
element for processing by a particular group of routines is to queue it 
to the PAB for that group. | 


After the work element is queued to the PAB, the PAB is scheduled to be 


dispatched. A PAB is scheduled by queuing it to the asynchronous 
process table (APT) or to a chain of PABs already queued. 
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There are several chains of PABs. Each chain is for a different kind of 
gi processing, and each has a different dispatching priority. When 
: ( ‘ ACF/VTAM has processed a work element, the APT is searched for the first 
a PAB in the highest priority PAB chain. The address of the work element 
is taken from the PAB and placed in the request parameter header (RPH). 
The RPH is a control block that contains the work element address and 
es other data pertaining to the processing environment. The address of the 
( RPH is put into register 1, and control is given to the first routine 
designated in the destination vector table. ACF/VTAM execution then 
continues until a work element is queued to another PAB for the next 
process. The queuing, scheduling, and dispatching of a work element are 
done by the process scheduling services (PSS) component of ACF/VTAM. | 


PABS USED BY MAJOR CONTROL BLOCKS 


Figure 2-11 lists the standard PABs that are used in ACF/VTAM process- 
ing. An entry in the list consists of the major control block that. 
contains the PAB, the name of the PAB, and the names of the work 
elements that can be associated with the PAB. 
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ATCVT 


FMCB 


j ICNCB 


LDNCB 


Figure 2-11. 
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ACDNEPAB 


ACDSSPAB 


(Receive Any PAB) 
(System Service PAB) | 


APTXPAB (TPIO SEC PAB) - 


APTXPABE 


APTXPABIL 


APTXPABN 


ATCCSPAB 


ATCITPAB. 


ATCLUSRT 


ATCNOSPB 


ATCNSPAB 
ATCPOPAB 
ATCPUIOP 


ATCPUPAB 
ATCPXPAB 


ATCSMPAB. 


ATCTCIPB 


ATCTMRPB 


- ATCVDPAB 


(TPIO TSEXP PAB) 


(TPIO TSIP PAB) 
(TPIO TSNORM PAB) 


(SSCP Configuration Services PAB) 


(Internal Trace DYPAB) 
(LUS Router DYEED) 
(NOS DYPAB) 


(TSC No. Session DYPAB) 


(Program Operator DYPAB) 
(PU Services I/O DYPAB) 


(PU Services DYPAB) 
(SMS Dynamic Expansion DYPAB) 


(SSCP DYPAB) 


(TOLTEP DYPAB) 


(Termination Task DYPAB) 


(VARY Definition DYPAB) 


TSPTSIP (TSC Inbound PAB) 


TSPTSOP 


ICNPCPAB 


ICNUFPAB 


LDNPCPAB 


LDNUFPAB 


(TSC Outbound PAB) 


(TSC Path Control Routing PAB) > 
(TSC Utility Function PAB) 


(TSC Path Control Routing PAB) 


(TSC Utility Function PAB) 


LUCPAB (TSC Path Control Routing PAB) 


UECPAB (User-Exit PAB) 
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Major Control Block PABs 
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Each chapter in this part describes the operation of an ACF/VTAM compo- 


nent. 


A component is a collection of routines that act together to 


perform a set of related functions. ACF/VTAM Logic, which is more 
detailed than this manual, is organized by component in the same order 
as Part 2 of this manual. Module-naming conventions (which follow) show 
the components, their chapter numbers in this manual, and their method- 
of-operation (MO) and program-organization (PO) subsection numbers in 
ACF/VTAM Logic. : 


Chapter 
Chapter 
Chapter 
Chapter 
Chapter 
Chapter 
Chapter 
Chapter 
Chapter 
Chapter 
Chapter 
Chapter 


Chapter 


Chapter 


Chapter 


Chapter 


3. 


Initialization and Termination 
System Definition (SYSDEF) 
System Services Control Point (SSCP) 
Network Operator Command Facilities 
Network Inquiry 
OPEN/CLOSE 
Application Program Interface (APTI) 
Transmission Subsysten Component (TSC) 
pees - 


Process Scheduling Services (PSS) 


Storage Management Services (SMS) 


Reliability, Availability, and Serviceability (RAS) 


Physical Unit Services (PUS) 

Logical Unit Services (LUS) 
Kultisysten Networking Facility (MSNF) 
Encrypt/Decrypt Feature 


Teleprocessing Online Test Executive Program (TOLTEP) 


MNODULE-NAMING CONVENTIONS 


The names of the ACF/VTAM modules point to the component to which the 


module belongs. Module-naming conventions are in the following fora: 


ISTxxyzz is the full module name, where: 


IST identifies the module as an ACF/VTAM nodule. 


xx identifies the component as follows: 


CON IER ERRIDYaMREMMRITp Hepa Fm heer ern I AT RA TO NEE EOE TN I ET STE BEBE TEST RITE ITO ORT AE E 


SSCP configuration services (activation) 
application program interface 

process scheduling services 

SSCP cross-domain resource manager 
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CF network operator command facilities or initialization 
CP . system services control point (SSCP) | _ 


DE SSCP configuration services (deactivation) 

ES process scheduling services 

IN initialization/termination or system services eonerel point 
LU logical unit services | 
MA SSCP maintenance services | _ e : | AS 
MG SSCP management services | ae, 
NO network operator services 

Oc OPEN/CLOSE 

OR storage management services 

PU physical unit services 

RA reliability, availability, and serviceability 
SD system definition 

SQ network inquiry 

ST network inquiry | , | . 
TS transmission subsysten “3 


y identifies system dependencies as follows: 


A OS/VS1 

Cc common to DOS/VSE, OS/VS1, and 0s/¥s2 MVS 
E DOS/SVSE 

F common to OS/VS1 and OS/VS2 MVS 

M OS/VS2 MVS 


zz identifies the individual L nodule 


Figure P2-1 relates the ACF/VTAM components to ae fourth and fifth 


characters of tas module names. = | | - | 

| a 
CONVENTIONS USED IN METHOD-OF-OPERATION DIAGRAMS | - ned 
The chapters in this part describe how functions are performed by the va 


components of ACF/VTAM. Each component is illustrated by a 
method- -of-operation (MO) diagram. These diagrams correspond to the 
overview diagrams in the more detailed ACF/VTAM Logic. 


The method-of-operation diagrams are . based on the input-process-output 
sequence. The input to the component (or subcomponent) is shown on the 
left side, the process steps are listed in the center, and the output is 
shown on the right side. Arrows relate data in the input and output 
sections to the appropriate processing steps, show the sequence of 
processing, and indicate fields that contain important addresses. 

Figure P2-2 explains the meanings of the arrows used in the diagrams. 


Only the last five characters of control block names are shown. Fields 

within control blocks are indicated by name or by content. Field names P 
usually start with the fourth, fifth, and sixth characters of the 

control block name. Only relevant fields are shown; if space is left 

before or after a field it means that the data area contains other 

fields that are not relevant as input or output for this function. A 

Space does not indicate how many fields were omitted. The order of the 

fields shown in the input and output boxes does not neceeetten corre- 

spond to the actual order of fields in the data area. 
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(> Unique 


Module Chapter MO/PO 
aed ACF/VTAM Letters in This Subsection 
Components (4th & 5th) Manual in PLM 
Initialization IN, CF 3 1 
and 
pee Termination 
( System SD 4 2 
: Definition 
System Service IN, CP - 5 3 
Control Point 
9 Network CF 6 4 
Operator Com- 
mand Facilities 
Network sq, ST 7 5 
Inquiry 
OPEN/CLOSE Oc 
Application Al 
Program 
Interface 
Transmission TS 10 8 
Subsystem 
Process AP, ES 11 9 
’ Scheduling 
Services 
Storage OR 12 10 
Management 
Services 
Reliability, RA 13 11 
Availability, and 
Serviceability 
Physical Unit PU 14 12 
Services 
i cad 
Logical LU 15 13 
Unit . 
Services 
 Multisystem CD, CP, IN, 16 Multisystem . 
Networking $D,SQ Networking & 
Facility Facility Logic 
Encrypt/ CD, CP, IN, 17 Encrypt/ 
er Decrypt Feature oc, SO, SQ, Decrypt 
{ Ts Feature Logic 
Me TOLTEP 18 Teleprocessing 
Online Test 
Executive : 
Program . 
Figure P2-1. ACF/VTAM Components 
and Identifying 
Module ID Characters 
Arrows used in the method of operation diagrams: 
» C—_) Shows major entries and exits on a diagram. Indicates data that is tested or read (but not 
changed) by a processing step. 
C_» Indicates that control is surrendered and returned. 
Arrow used in pairs to connect a step on one Arrows indicating that data is tested or read may 
[—) diagram to (1) a step on another diagram or (2) a be keyed to avoid crossing other arrows. 
_ step on a different page of the same diagram. 
Se ’ =) Indicates data that is moved or copied by a 
Arrow used in pairs to connect one step to : 
; processing step. 
another step on the same page of a diagram. 
Shows that a field in one data area contains the ==> [a] Arrows indicating that data is moved or copied 
nO sidress of another field or data area. may be keyed to avoid crossing other arrows. 
Figure P2-2. Arrows Used in the Method-of-Operation Diagrams 
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CHAPTER 3. INITIALIZATION AND TERMINATION 


Initialization and termination services establish the ACF/VTAM operating 
environment; that is, they define the domain structure and identify 

i system resources. When ACF/VTAM is to be terminated, these services 

( stop I/O and session activities and close down the domain. 


An overview of initialization and termination is shown in MO 1. 
INITIALIZATION 


Initialization is a synchronous process that begins when the systen 
Operator issues an EXEC PROC= (DOS/VSE) or a START command (OS/VS) that 
names the ACF/VTAM procedure. The load module or phase that connects 
ACF/VTAM to the host operating system is also loaded by the host operat- 
ing system as the result of a START VTAM (OS/VS) or an EXEC VTAM 
(DOS/VSE) command. The initialization modules then process the start 
options and network configuration parameters and load the other ACF/VTAM 
modules. Initialization then acquires buffer pools, builds the ACF/VTAM 
command processor gueues, opens the ACB for the SSCP, attaches ACF/VTAM 
subtasks and threads, generates internal VARY ACT commands for each 
major node name specified in the configuration file and routes the 
commands to the SSCP (which processes them asynchronously), starts 
user-specified traces, and, in DOS/VSE, initializes operator-to-ACF/VTAK 
communication. The initialization subcomponent then continues to run 
after starting is completed, acting as a command router for all ACF £VTAM 
operator commands. 


TERMINATION | : : 7 ; 4 
_— | - Termination is a synchronous. process that reverses the actions under- 
{ taken by the initialization subcomponent. Termination occurs as a result 


of a HALT command. The HALT command specifies whether ACF/VTAM is to be 
terminated in an orderly way (HALT), which allows application programs. 
to end their sessions at their convenience and allows full operator 
command capability, or in an immediate manner (HALT QUICK), which 
disallows any communication between logical units and allows only 
limited operator command capability. In an orderly halt, application 
programs are allowed to close their ACB. Once all the application 
programs have closed their ACBs, immediate halt logic is entered auto- 
; matically. During immediate halt processing, ACF/VTAM subtasks and 
threads are terminated, application programs with open ACBs are notified 
of a HALT QUICK and I/O processing for their sessions is stopped immedi- 
ately, major nodes are deactivated, queues are dismantled, and storage 
areas are released. Once the application programs have closed their 
ACBs, eee a a ee communication is terminated, and all ACF/VTAM 
phases are deleted.. 


In OS/VS systems, a HALT CANCEL command forces ACF/VIAM out of the 


system. This command causes the operating system's command scheduler, 
SVC 34, to schedule ACF/VTAM for abnormal terminaticn. ~~ 
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MO 1 (Part 1 of 3).” Initialization and Terminatior 


‘Input | Processing Output 
ae See Note A 


Initialization 
Process start options. 


Initialize primary 
ACF/VTAM tables, buffers, 


queues, and DVTs.. 


Start Parameters 
Reenterable Modules 


CONFT 


Reenterable Modules 


e Load reenterable modules. 
e Build buffer pools. 
@ Open SSCP ACB. 


e Attach subtasks and 
threads. 


@. Build basic network. 


RDT Chain 


Wait for operator command. 


Network 
Operator or 
Termination 


Route command to proper 
component for program- 
ming. . 


Reg 1 TS 


DISPLAY, 


VARY, 
MODIFY, or _ To Command 
HALT Processor 


command. 


Start options are stored in 
B.ATCSTRxx in the source state- 
ment library, or they can be |. 
entered from the console by the 
network operator. 


DISPLAY command is handled by 
network operator command 
facilities... 


' HALT or HALT QUICK command is : 
handled by Termination (Step 5). ; oa: - nS 


VARY command is handled by SSCP. 


' MODIFY command is handled by 
SSCP. 


Entry is from system dispatcher 
(DOS/VSE), system master 

_ Scheduler (OS/VS1), or system 
scheduler (OS/VS. MVS). 


In OS/VS systems the ACF/VTAM 
partition or region size. or 
address space for the system 
must be specified in the JCL 
before the START options are 
processed. 
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MO 1 (Part 2 of 3). 


Input 


From Step 4 
Command Router 


aN 


The operator can enter either 
HALT or HALT QUICK to terminate 
ACF/VTAM. HALT means that ap- 
plication programs connected to 
ACF/VTAM are not forced to dis- 
connect themselves, but applica- 
tion programs not using ACF/VTAM 
at the time the HALT is issued 
are denied access. 


Full command capability is allow 
ed until either a HALT QUICK is 
issued or all the application 
programs close their ACBs. HALT 
QUICK means that the network is 
to be shut down immediately. 
Application programs not using 
ACF/VTAM are denied access. 
Existing I/O requests are pro- 
* cessed, but new I/O requests 
and session requests are not 
allowed. Only a few commands, 
such as DISPLAY and VARY INACT, 
F, are allowed. . 


HALT CANCEL (available in OS/VS1 
and OS/VS2 MVS only) means 
immediate abnormal termination 
of the ACF/VTAM task. ACF/VTAM 
application programs are noti- 
fied by TPEND exit or are ab- 
normally terminated to force 
ACF/VTAM out of the system. 
Locally attached data communica- 
tion devices are freed, and 
ACF/VTAM storage is returned to 
the system. 


Termination waits for the CDRMs 
to be deactivated by SSCP before 
continuing. 


Processing 


Initialization and Termination 


Output 


Termination 


Determine type of HALT 
command. 


Indicate type in ATCVT. 


Reg l 
If HALT QUICK: 


UECB 


Shutdown 
Request 


Request each application 
program to handle its own 
shutdown. 


Return to the command 
router to process further 
commands until all appli- 
cation programs are closed. 


Command Router 
(Step 4) 


Notify ACF/VTAM subtasks 
with open ACBs of HALT 

QUICK and wait for informa 
tion. 


Request each active appli- 
cation program to handle 
its own shutdown due to 
HALT QUICK. 


Schedule deactivation of 
CDRM segments. 


Schedule deactivation of VARY INACT,I (Internal) 


all other major segments. 
=-—--- 2 


a. 


Termination waits for these seg- 
ments to be deactivated before 
continuing. 


Licensed Material—Property of IBM 


Chapter 3. Initialization and Termination 53 


MO 1 (Part 3 of 3). Initialization and Termination 


Input Processing i. Output 


In OS/VS, notify termina~ 
tion subtask of HALT QUICK 
and wait for it to termi- 

nate. 


Deactivate application 
program segments and 
ACF/VTAM threads. (DOS/VSE) 
without ACBs or subtasks 
(OS/VS) . a" 


Notify system operator 
that ACF/VTAM is termi- 
nated. 


Delete tables, queues, 
and loaded modules. . 


ATCVIT 

aa 
Address of VTAM 
Modules Terminated 


Return to 
System 


4 
z 
z 
z 


—— The composition of the network is identified to ACF/VTAM through the 
ACF/VTAM definition deck. There is a group of statements for each set 
of: 

( e Application programs 


e Lines and terminals attached to the NCP 

: ® SNA terminal products attached over switched lines 
e SNA terminal products attached over the channel 
e Non-SNA terminals attached over the channel 
e CDRMs and CDRSCs 
e Path tables 
Except for path tables, each group of statements represents a major node 
in the domain. 
A resource definition table (RDT) segment is built for each major node 
and is composed of a header followed by a number of entries. Each entry 
represents a node within that major node. Consequently, each RDT 
segment is a collection of specific (minor) node entries that are 
related by being part of one major node. After the generation decks. 


have been processed, ACF/VTAM has a control block representation of the 
data communications system. There is an RDT segment for each: 


e Application program major node (with an entry for each application 
program defined) 


ae ® NCP major node (with an entry for each line and device connected to 
{ | that NCP) 

e Switched SNA major node (with an entry for each PU and LU defined) 

e Local SNA major node (with entries for each local PU and LU defined) 


e Local non-SNA major node (with entries for each local non-SNA 
terminal defined) | 


. @ CDRM major node (with an entry for each CDRM defined) 
e CDRSC major node (with an entry for each CDRSC defined) 
: No RDT segment is built for a path table. 


An overview of system definition operation is shown in MO 2. 


System definition also handles CIDCTL macro instructions issued by other 
ACF/VTAM components to obtain information from the addressing control 
blocks. 


C | The ACF/VTAM system address shown in Figure 4-1 is called a communica- 
a | tion ID (CID). A CID has a 2-byte secondary network address and a 
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2-byte primary network address. The primary and secondary network 
addresses each contain two values. The first value (the major node ID) 
is an index into the major node table to find an entry fora specific 
node table. The second value (the specific node ID) is an index to the 
specific node table. 


When an application program sends an I/O request or message to a specif- 
ic node, the primary network address is used to find the node control 
block or LUCB; then the secondary network address is used to find the 
FMCB that is chained off the NCB or LUCB. The secondary field of the 
CID contains the destination node's network address, and the primary 


field contains the application program's network address. Thus, the CID 


is a system address that uniquely identifies both the destination node 
and the application program with which it is in session. 


‘Communication ID 


Secondary Address . | Primary Address 


Major Specific Major Specific 
Node ID Node ID Node ID Node.ID 


| 3 Destination Node’s | Application Program’s . 
eae ct a 
Network Address Network Address. 


-<————— 2 bytes + 2 bytes. —————» 


ed - 


Figure 4-1. Format of a Communication ID 
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MO 2. System Definition 
Input | Processing Output 
Generation Decks for Major 
Nodes and Path Tables Describe to ACF/VTAM the 
a characteristics of the 
domain by building resource 
definition tables. 
A RDT Segments 
Describe to ACF/VTAM the Poe 
present configuration of id 
the addressable nodes in 
: domain by building or up- 
dating specific (minor) ae 
od node tables. 
Load interpret tables and Rd 
build RDT suffix. 
SNT 
Update table of symbolic — 
node names. Add and de- Before node is opened {| 
wena ed 
as required. saan 
After node is opened 
NCB or LUCB 
Find application program : oe 
RDT segments and entries. Node Control Block 
Process requests for CID | 
handling. 
Interpret 
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The system services control point (SSCP) is a collection of routines 
that control the domain configuration by activating and deactivating 
nodes, participate in establishing and terminating sessions between 
nodes, and provide various measurement and maintenance services. The 
SSCP can be divided into five main pape emponents: 
o Configuration services 

® session services 

e "ress aouain: resource manager (CDRA) 

e Maintenance services 

® Measurement services 


An overview of SSCP operation is shown in MO 3. 
CONTROLLING: THE N REIHORE | CONFIGURATION 


Once the initial network configuration has been defined, the SSCP 
routines handle requests from the network operator to activate and 
deactivate nodes. The operator can modify the network configuratioB to 
compensate for such changes as increased or decreased workload, hardware 
failure of one or more network components, or a change in application. 


program throughput. After changing the configuration, the operator can | 


display the status of the network or one of its components (see Chapter 
4). The star Aide operator commands used to modify the nOENOEs are: 


® VARY, which activates and deactivates nodes’ 


e MODIFY, which changes the operational characteristics of ACF/VTAB. 


HONITORING SESSIONS 


The SSCP routines also assist in initiating and terminating sessions 
between logical units in a network. Two types of sessions aust be 
established before communication between logical units can take place. 
First, the SSCP establishes a session between itself and the device 
(such as a cluster control unit) with which it will communicate. This 
session is between the SSCP and the controlling portion of the device, 
known as the physical unit services (PUS). Second, the SSCP establishes 
a session with one or more of the pOgseee units associated with the 
device. pam 7 


When the SSCP has established sessions with one or more logical units, 
it is ready to handle and monitor communication between the logical 
units. The communication between the SSCP and a logical unit involves 
two types of data flow: 


@ Normal flow (inbound or outbound): In this type of flow, requests 
are sent sequentially, one after the other. A request that was sent 
before another request must arrive sooner, and, if a response is 
indicated for both, the response to the first request must be sent 
back before the response to the second request. 
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e Expedited flow (inbound or outbound): In this type of flow, an 


important request (usually one that contains control indicators) is 
transmitted immediately, ahead of normal flow requests that are 
awaiting transmission. Only one expedited flow request can be sent 
at a time, and a response must be received to one expedited flow 
request before another can be sent. 


These two types of data “aoe one =e two - types of sessions are shown in 
Figure. Smt. - ne , | 


Through the SSCP, a session is <entablisned Geiveck: tvo: logical units. 
The commands used for establishing and controlling sessions between the 
SSCP and logical units are: : 


Contact, which the SSCP sends to an NCP or PU services to request the 
activation of data link control contact with the station associated with 
the specified adjacent phyercak unit. | 


Activate Physical Unit, which the SSCP sends to establish a session 
between the SSCP and a physical unit (such as an NCP or cluster control 
unit). , . | 


Activate eoqical Unit, which the SSCP sends to establish a session 
between the SSCP and a logical unit. 


Initiate, which is.sent from a logical unit to the SSCP to request that 
a session be established. This includes character-coded logons that the 
SSCP converts to tnitiate Self -onnencs. 


Terminate, which is “sent from a poledical. “anit to the SSCP to end a 


session between logical units. This includes..character-coded logoffs © 
that the SSCP converts to Terminate Self. commands . | 


between the SSCP and a a i. unit. 


Deactivate Physical Unit, which the SSCP sends to terminate the session 
between the SSCP and a physical unit. 


When a node receives one of these commands, it lial as aia 
requested, to indicate that the command has been received. 


Logical Unit | 
! Control Block 


Cluster Control Unit 


Physical 
Unit 


Function Management 
Control Block for . 
SSCP-PU Session 


SSCP=-PU Session 


(After SSCP=PU 
Session Established) . 


Normal Flow (Outbound) 


Normal Flow. (Inbound).. 
Expedited Flow (Outbound) — 
: _ Expedited Flow (Inbound) 


‘|: Function. Management 
~ Control Block for. | 
SSCP=LU Session =” 


SSCP=LU Session 


Figure 5-1. Establishing SSCP Sessions for Data Transmission 
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Figures 5-2 through 5-21 illustrate the flow of requests and responses 
between the SSCP and logical and physical units to establish and terni- 
hate sessions. The following cases are illustrated: 


Activation of an NCP major node 
Activation of a cluster control unit 
Initiation of a session by a logical unit 


Initiation of a session by an application program issuing a SIMLOGOR 
macro instruction ens 


Initiation of a session by an application program by issuing an 
OPNDST ACQUIRE macro instruction 


Initiation of a session between two application programs 


Establishment of a switched connection 


Sending a ‘character-coded request: to the SSCP 


Immediate termination of a session requested by a logical unit 


Termination of a Session ‘by @ an application Program that is the 
primary end | 


Termination of a session bY an application program that is the 


secondary end 
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Operator's : | Communications 
Console © SSCP . PU Services Controller | PU LU. 


| vactNcp | | 


COND LOAD 


+RESP 
SDT oY &- 
— f _. -__+RESP_ 
STD 7 See | 
RESP 


+RESP 


+RESP(CONTACT) 


CONTACTED | 


NOTIFY 


+RESP(ACTLU) 


+RESP(GMM) 


Figure 5-2. Activation of a Local Communications Controller 
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Operator’s Communications 
Console SSCP PU Services Controller PU LU 


NCP | 
| _V ACT NC | CONTACT 


__CONTACTED: | 
ACTPU 


“ 


STD 


+RESP 
ACTLINK 


NOTIFY 


SS SS 


Figure 5-3, Activation of a Remote Communications Controller 
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- Operator’s | _ Communications 


Console SSCP Controller PU | LU 
| _V ACT LINE | | | 
) 1 _ACTLINK 
+RESP 
+RESP. meas 
CONTACT 
4 


4 


CONTACTED | 
t 
ACTPU 


ee 


NOTIFY ae 
ACTLU 


tm gw gay 


estoy | 


= 
Operator's. a | Communications > ae. 7 
Console —  -$SCP _ Controller os - PU iG LU 
{ VACTRIN: | ; 
, “| _ CONTACT 


* 


CONTACTED 
poe 


Figure 5-5. Activating a Cross-Subarea Link Station 


+RESP_ 
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Console SscPp 


a 2 | vact pu 
Act eu __.f CONTACT 


Controller PU 


( — Operator’s Communications 
x . 


LU 


CONTACTED i 
ACTPU 
ne N 
r | +RESP = * 
+RESP * 
—amnmne ACTLU 
: eee aa ee ee 
H iis, See 
3 ch ae a ee 
+RESP(ACTLU) l 
eee eres, (Renee ane 
+RESP (GMM) 
7 | 
Note: For PUT1, ACTPU is processed at the Boundary Function 
Figure 5-6. Activating a Physical Unit Type l or Type 2 
a | ; . 2 . “- 
Operator’s Communications 
, i Console sscPp Controller PU LU 
(| | v ACT LU | , 
is ; ACTLU 
& 
ee eS OE 
Figure 5-7. Activating a Logical Unit 
Operator’s 
Console —sscp PU Services LU Services EU 
: | _vact Lu 
+RESP | 
OPEN ACB 
OACBRU F —— 
| ADDNR I 1 
+RESP : 
* +RESP 
| actLu * 
ea i ae es cel 
7 Figure 5-8. Activating an Application Program 
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EU PLU PSSCP SSSCP stu EU | eS 


| eneee ACO | 
| opwosr aca | INITIATE 
: 1 _CDINIT 


| | +RESP 
| | CDCINIT- | 


t_+RESP 
2 |_SCIP EXIT 
oe OPNSEC 
+RESP. . 
: : ——* |+RESP 
CDSS 
* ; 
__+rese | 
7 ¢ SCIP EXIT 
Figure 5-9, Primary Logical Unit Initiate (OPNDST Acquire) 
= ~ - _ 
EU PLU PSSCP Ssscp stu_ BU “ie ; 
| -_ 7 | | | 


| SIMLOGON | 
H INITIATE 


| | “1 CDINIT 


-+RESP |. 
_” +RESP ee 
+RESP - ast oe | | 
. ws | —_ CDCINIT 
|  CINIT cama (ale 
‘LOGON EXIT 


7 +RESP 
4 * 
OPNDST ACC | 
! +RESP 


SCIP EXIT | 


: +ReSes +RESP | 


a 
‘e 


CDSS 


* SCIP EXIT 


Figure 5-10. Primary Logical Unit Initiate (SIMLOGON) 
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CDINIT =A And 
+ 


+RESP | 
+RESP 


| “LOGON SUCCESSFUL” 
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+RESP | 


CDCINIT | 


LOGON EXIT f 


OPNDST ACC | 
H +RESP 


# 


| BIND 
* 


ms 


+RESP 


* 


ee +RESP 
ss | 
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SDT 
Ee eee +RESP 
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+RESP I | 
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Figure 5-11. Secondary Logical Unit Initiate (LOGON) 
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Figure 5-12. - Secondary Logical Unit Initiate (REQSESS) 
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Figure 5-13. Secondary Logics 
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Figure 5-15. Inactiva 
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Note: To establish a switched connection the SSCP sends an Activate Link command to indicate 


Definite Response 1 
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the link is active. An Activate Connect In command is sent to enabie the communications 
controller to answer incoming calls. (Instead of Activate Connect in, Dial could be sent to 
initiate an outbound call.) When a call comes in, the communications controller sends an 
XID (exchange identification) and the physical unit responds with its 1D (station address). 
The communications controller sends a Request Contact (Offhook) command to the SSCP. 
SSCP sends a Set Control Vector command containing address and pacing information to 
the communications controller. The standard activation sequence (Figure 5-3) then occurs. 


Figure 5-16. Establishing a Switched Connection 
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In this example, the logical unit sends a character-coded logon or logoff to the SSCP. 
The unformatted system services portion of SSCP converts the logon into a. field- 
formatted Initiate Self or Terminate Self command. The command is then passed to 
the SSCP request processor. If the return code indicates an unsuccessful transmission, 
unformatted system services converts the command into a form understandable to the 


terminal logical unit. 


Figure 5-17. Sending an Unformatted Request to the SSCP 
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Figure 5-18. VARY TERM Forced | ! 
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Figure 5-19. VARY TERM Cleanu 
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Figure 5-20, ERP Processing 
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CLEANUP 
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NSEXIT 


LOST PATH 


CDRM Session is lost 


Only for sessions involving the subarea of the HOST and the subarea that is reported “LOST” 


Figure 5-21. Lost Subarea Processing 
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Configuration services is the SSCP subcomponent that manages the 
configuration of the network. Configuration services records the status 


-of each resource in the network. It updates these records should the 


status change as a result of requests received from network operators 
(such as VARY ACT or VARY DEACT commands) and as the result of requests 
and responses received from the resources themselves (such as INOP, REQ 
CISC, or ACTLU RUs). (See Figure 5-22.) Configuration services also 
supports miscellaneous commands that are used to modify the characteris- 
tics of the network resources (such as a VARY ANS command). (See Figure 
5-23.) 


The status of each resource is kept in its RDT entry in the form of a 


finite state machine (FSM). At any instant, the finite state machine is 


in a single state. The FSM shifts to a different state only as a result 
of a specific triggering event. The triggering event could be either an 
ACF/VTAM command or an internal SNA command. For example, if the 
current state of an FSM that represents a nonswitched logical unit is 
INACTIVE and the triggering event is a VARY ACT command for that logical 
unit, configuration services sends an ACTLU request and changes the 
state of the FSM. to PEND ACTLU RESP. If the next triggering event is 
the arrival of a positive response to the ACTLU, configuration services 
changes the state of the FSM to ACTIVE. 


MAINTENANCE SERVICES 


Maintenance services is the SSCP subcomponent. that handles terminal-user 
echo test processing. The terminal-user echd test allows a terminal 
user to verify that a path to ACF/VTAM is operational. The user can 


optionally provide test data to be sent to ACF/VTAM and specify how many 


times the data is to be returned. Should ACF/VTAM receive test data 
from a terminal, ACF/VTAM returns the test data, preceded by "IBMECHO", 
to the originating terminal the requested number of times. 


MANAGEMENT SERVICES 


Management services is the SSCP subcomponent that handles Forward RU 
processing. Forward RU processing is used when a communications network 
management (CNM) application program requests that the SSCP forward an 
RU to another network addressable unit. 


Licensed Materiai—Property of IBM 


74 =. 


tae ecm tiene nG ne ane eH Stoner Eh CONTR sty Ae Pil at wt? Never SpA EN Silt bn ama HES ne ah al AD Ss acm A Nl Sat ha A ASR in SR SL Se ED BA ABE i EG a rt 


Pees en 8 Raat ile BS Ron ita LI EOE NEE ENA OT tRNA - eee = 


ans 


sceneries epee es Sis aah NG NAL IRIE OB Talc aE ERE EC OE EE OED TC Re ee PERE Ee ee eee ag ee ee ee ne ae EEE 
> aM ae ee Re RR UL | SO ee ty ge Rig ager 2 a z i 
aa nob ogtt Pye WE Te ae ies BPC. Spares Se dais Salta ae Sy ee ae 


~~ 


LOLLY LTTE RE TEEPE TESTI AE AER ER LST AR RTT ESE STE SEBO” LTE TS RE TE EP EE IN I ET I A IE IE TE TL I A TCT 


(> 


Network 
Definition 


Statements (DOS/VSE) RDT 


Current State of 
Major and 
Minor Nodes 


Optional 
NODELST 
Data Set 


Activation and Deactivation 
of Major Nodes 


Network or 
Program 
Operator 


Changed within 
Major Nodes 


*For delayed configuration Optional 
restart only. There can be Configuration 
one data set for each check- Restart Files* 


pointed major node. = a 
Figure 5-22. Recording Changes to the Network Configuration “4 
syst VTAMLST aes | 
_ | (if it exists), or 
OS/VS.¢ SYS1.VTAMOBJ 
(if there is no ) 
ACF/VTAM 
SYS1.VTAMLST) A 
SYSSLB | 
(DOS/VSE) — A RDT 
ajor r) 
Information ay ACE/VTAM 
Network 
— For Cold Restart Configuration 
List Identified 
by CONFIG Data Set 
Operand or Identified 
by CONFIG 
Operand 


VSAM 


; ; For Warm Restart 
Configuration 


Restart 
- Data Sets 


Minor Node Information 


Figure 5-23. Delayed Configuration Restart 
Licensed Material—Property of IBM 
Chapter 5. System Services Control Point (SSCP) 75 


ee, was ee ae ee ee EBT ee HE LRT EL NE HLT OE ETE ION LT LE eS Te SOT I ARO ES 


MO 3 (Part 1 of 6). System Services Control Point (SSCP) 


Input Processing 
) From PSS (MO 9) 


Mainline router, routes 
control to appropriate 

routine to process NCSPL 

command . 


‘Register 1 NCSPL 


Command 


Return. 


To 
Caller 


Node Activation. 


SSCP Command 
Router (Step 1) 


a. Node not known. | 


Register 1 NCSPL 


ee 


System 


(MO 2) 


b. Node known. issue. 
FMCBADD. — 


SSCP processing is set up when 
the SSCP initial router is 
called by the ACF/VTAM task _ 
control routine to queue newly 
built NSCPLs to the VARY FE PAB. 
The SSCP mainline router re- 
ceives control from PSS and: 
either processes the NCSPL 
command internally or calls the 
appropriate routine to process 
the command. 
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MO 3 (Part 2 of 6). System Services Control Point (SSCP) 


Input Processing | Output 


Active RDT 
entry 

c. Activate major nodes 
and minor nodes. 


Return. 


To Caller 


The activation subcomponent of 
SSCP receives control from the 
SSCP router and makes major and 
minor nodes known and available 
to ACF/VTAM. 


a. If the major node to. be 
activated is not known, this 
subcomponent uses system 
definition to build an RDT 
segment for the major node. 


The activation subcomponent 
issues an FMCBADD macro 
instruction to build an FMCB 
on which to schedule any SSCP 
I/O for the node. 
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MO 3 (Part 3 of 6). System Services Control Point (SSCP) 


q Ne 
¢. . ‘ a x 
Input ee Processing Output , ao ; 
: -_ 
Node deactivation nes 
, Inactive RDT 


SSCP Entry 
Command: a. Deactivate major and 
Router minor nodes. 


Register 1 (Step 1) 


System 
Definition 
(MO 2) 


Caller 


‘Dump/load/restart subtask 
(OS/VS) or thread 
(DOS/VSE) . 


ISTINCDP 
to Post 
ECB 


Register 1 NCSPL 


or 


a. Route request to proper 
routine for processing. 


Register 1 


Wait for 
Next 
Request 


The deactivation subcomponent 
of SSCP receives control from 
the SSCP router to deactivate 
major and minor nodes and make . - 
them unknown to ACF/VTAM. 
the major node is inactive, 

SSCP calls system definition to 
release the RDT segment. 


a. For normal deactivation, it 
waits for the user session 
to end and then deactivates 
the node. For immediate or an 
forced deactivation, it 
forces the end of the user 
session and then deactivates 
the node. 


The dump/load/restart subtask 
receives control when a DLRPL 
or an NCSPL is queued to the 
D/L/R work queue and the D/L/R 
subtask is posted. 


a. Processing depends on the 
type of request. The func- 
tion is performed by a call 
(DOS/VSE) or an ATTACH 
(OS/VS) to the appropriate 
D/L/R routines to handle 
the request. 


Processing includes: 
e Dump NCP 
@ Load NCP 


@ Local PU activation/ > oe 
deactivation aon 


Operator query 
Checkpoint configuration ; Nia?” 
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MO 3 (Part 4 of 6). System Services Control Point (SSCP) 


Input Processing 


aa SSCP I/O 


From SSCP 
Subcomponents 


Register 1 
Process I/O operations for 
SSCP VARY commands. 


Control commands and purge 
requests for: 


e Communications (aes 


controllers TSC (MO 8) 


Status and LU command 
for SNA cluster 
controllers or 
communications 
controllers 


Feedback and requests 
for local devices 


PSS (MO 9) 


Error recovery processing 


Force PSS (MO 9) 
Deactivate 


NCSPL 


Register 1 


a. For soft errors, 
attempt recovery. 


b. For hard errors, purge 
connections. 


RDT Entry of 
-Pailing Node 


PSS (MO 9) 


The I/O subcomponent of SSCP 
receives control from other 
SSCP subcomponents. It handles 
I/O processing for any nodes 
requiring I/O. 


The Configuration Services sub- 
component of SSCP receives con- 
trol from PSS. Entry is by 
TPQUE for an INOP, force de- 
activate, or when an I/O 
operation has been completed, 
for Configuration Services. 


a. If the error is recoverable, 
attempt recovery and issue 
soft purge to SSCP session 
with failing node. 


If the error is not recover- 
able, terminate all sessions 
and schedule a deactivate 
request for the node. 
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MO 3 (Part 5 of 6) 
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MO 3 (Part 6 of 6). System Services Control Point (SSCP) 


Input 


Register 1 


VARY or 
MODIFY 
command 


ECB 
Posted 


Register 1 SSCP 


Router 
(Step 1 


VARY ACQ or VARY REL 


This SSCP subcomponent is a 
collection of independent 


command processors. Each 
processor handles a specific 
command as indicated in the 
NCSPL. Each command is an 
Operator command or an 
internally generated SSCP 
command. Commands processed 
include: 


@ VARY INOP 
@ VARY PATH 
@ MODIFY 
@ VARY ANSWER 


All SSCP command processing 
routines are called by the SSCP 
router. 


The tuning statistics subcompo- 
nent of SSCP is a subtask of 
ACF/VTAM. When first entered, 
it sets up the operating environ 
ment and waits for the following 
ECBs to be posted: 


e Time ECB 


@ ECB due to deactivation of a 
local programmable controller 


@ ACF/VTAM termination ECB 


When one of the above ECBs is 
posted, this module gets control 
to format and write tuning 
statistics. 
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SSCP 
Router 
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Network operator command facilities does the following: 


_@ The display processor displays information requested with DISPLAY 


commands issued by the network operator. 


e The TPMSG processor transmits operator messages to the network 
Operator or routes them to application programs that have been 
designated to handle program operator functions. 


® The program operator interface (POI) receives ACF/VTAM operator 
commands from authorized application programs (SENDCMD processing) 
and routes command responses and unsolicited ACF/VTAM operator 
messages to the authorized application programs (RCVCMD processing). 


e Network operator services (NOS) provides support for ACF/VTAM 
network operator commands. NOS is entered with an unformatted 
command issued by the network operator (for example, DISPLAY 
NCPSTOR), or with a formatted RU from the SSCP (for example, DELIVER 
RECORD STORAGE to get the results of a DISPLAY NCPSTOR). 


An overview of ACF/VTAM operator command facilities is shown in MO 4. 


{ 
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MO 4 (Part 1 of 3). Network Operator Command Facilities | 


Input 
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TPMSG Macro 
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Processing 


Displaying Status 


Obtain the requested 
status information. 


Issue TPMSG macro 


instruction to display 
status. 


Transmitting Messages 


Pass message to program 
operator interface or 


initiate transmission. 


Licensed Material—Property of IBM 


Output 


Network 
| Inquiry (MO 5) 


’ 7 | - 


(ae 


Initiali~ 
zation 
(MO 1) 2 
System 
Console 
Message or POWE 
Return to. 
Issuer of 
TPMSG 
7 
Pe “ee eS 
a 
ta he - J 
i i 


LOM GRO NT OEM LER TOL IS MEN LEER AIA A EE BLE EG LITE A EC NLR ARES CEE EO TE A MAEDA ASN SIRE RIE RITE ETE POP SHOOTS PSR 


= é = : Paayey a nner Ny AO es oe awed sin ng a ND Sates 
i eee a ie 4 + ye 2 Snfiy jane sa NA et a | 
Se IE Bt a me bigs Sed 1 RE Reda sass tb EE : Beet cape: B1sai oe 


my 
te 
Rich hes 


MO 4 (Part 2 of 3). Network Operator Command Facilities 
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Input Processing Output 


For RCVCMD requests, 
pass oldest message to 
the application program. 


RPL 


Message . 


bo 


PAB: 


PORCB 


For SENDCMD requests, 
pass command to appro- 
priate processor; for 
REPLY commands, pass 
the reply to the re- 
quester. 


OPEN/CLOSE 
Router (MO 6) 
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MO 4 (Part 3 of 3). Network Operator Command Facilities 


Input . Processing Output 


Network Operator Services . 


a. Perform the function 
requested by the 
operator command, 
either directly or by 
requesting services of 
the SSCP. 


Register 1 


Associate the RU re- 
ceived from the SSCP 
with the NOS procedure 
that initiated it, and 
complete the procedure. 


RUPERQP 


OPEN/CLOSE 
Router (MO 6) 


Network Operator Services pro- 
vides support for the network 
operator's interface to VTAM. 
Requests are received by NOS 
from the network operator, as 
unformatted commands, such as 
DISPLAY NCPSTOR, or from the SSCP, 

. a8 formatted RUs, such as DELIVER. 


NOS is a Communication System 

Manager (CSM) LU. It uses its o 
SSCP-LU session to request func- ; 

tions that it cannot perform 

directly. 


a. NOS understands what has to be 
done for each operator command. 
Where possible, it performs the ~ 
function directly. Otherwise, 
it sends RUs to the SSCP to 
request the desired function. 
These RUs can be either direct 
requests for SSCP action or 
FORWARDS of requests to be sent 
by the SSCP to a. NAU. 


RUs are sent by the SSCP to the 
NOS complete procedure request- 
ed on behalf of an operator 
command. For example, DISPLAY 
NCPSTOR causes NOS to forward 

a DISPSTOR RU to the SSCP. 

When the NCP replies with a 
RECORD STORAGE RU, it is de- 
livered to NOS, which formats 
the messages for the display. 
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This component contains the macro instructions that are issued by the 
DISPLAY command processor to obtain all the information that can be 
requested by a DISPLAY command. 


An overview of network inquiry operation is shown in MO 5. 
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MO 5 (Part 1 of 2). Network Inquiry 


Input . Processing 


INQUIRE. or 
INTERPRET 
Macro (See 
Note A, 
Part 2) 


Register 1 Gas: 


[ox] 
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OPEN/CLOSE 
Work Element 


Types of data that can be re- 
quested by INQUIRE and the 
source of information are as 
follows: 


@ Logon date - from the location 
obtained from LOGON SIB. 


® Device characteristics - from 
the node's RDT entry. 


@ Counts - by counting SIBs 
queued to the application 
program's RDTE. 


Terminal - by search of RDT 
entries for the specified node. 


Application program status - 
from the application program 
RDT entry. 


Display of a resource - from 
the RDT entry, node control 
block, FMCB and/or SIB queue, 
depending on the display re- 
quested. 


Communications controller 
name - from the RDT entry. 


CID translation - if CID sup- 
plied, from the RDT; if sym- 

bolic name supplied, from the 
FMCB. 


Top request on LOGON applica- 
tion program's logon queue - 
from the SIB queue and RDT 
entry. 


Session parameters - from the 

- logon mode table (pointed to 
by the RDT entry or ATCVT), if 
the application program speci~ 
fies NIBLMODE, or from the 
logon data buffers. 


OS Richa oe ae aa ae 


“aie 


For an INQUIRE request, 
locate the requested. 
-information and move it 
to the user's area. 


i] 


e@ Session key - from the FMCB. 


Network inquiry processing for 
domain display requests: 


@ DISPLAY MAJNODES ~ from the 
RDTE for each communications 
controller, local SNA major 
.node, local non-SNA major node, 
application program RDT segment, 
CDRM RDT segment, CDRSC RDT seg~ 
ment, and switched SNA major 
node in the domain. 


DISPLAY LINES - from the RDTE 
for each line off each active 
communications controller in 

the domain and its associated 
RDTE. 


DISPLAY TERMS/DISPLAY CLSTR < 
from the RDTE for each LU or 
terminal in the domain and all 
their associated higher-level 
node RDTES. 


DISPLAY APPLS - from the appli- 
cation program RDT segments in 
the domain. 


DISPLAY BFRUSE - from the buffer 
pool control blocks for each 
ACF/VTAM buffer pool. 


DISPLAY CDRMS/DISPLAY CDRSCS - 
from the CDRM or CDRSC RDT seg- 
ments respectively. 


DISPLAY PENDING - from the RDTE 
for each node in the system that 
has an outstanding SSCP request. 


DISPLAY PATHTAB - from the MNT 
entries. 
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MO 5 (Part 2 of 2). Network Inquiry 


( \ Input Processing Output 


For an INTERPRET request, 


translate the logon 
sequence number into the 
sequence specified in the 
interpret table for the 
resource. 


re” Register 1 


RPL 
|RECLEN or ARECLEN | 
Return Code 


OPEN/CLOSE 
Work Element 


Set return code. 


Logon 
Characteris- 
tics Table 


Return to 
Caller 


oes rentine | tater | net. 
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The logon sequence is specified 
by the AREA and RELCEN fields of 
the RPL. The sequence in the 
interpret table and its length 
are returned by the AAREA and 
ARECLEN fields of the RPL. 


If the major return code is 0 
(successful) the RPL field 
RECLEN (for INQUIRE requests) 
or ARECLEN (for INTERPRET re- 
quests) contains the length of 
valid data. If the major 

return code is 8 (error) and the 
reason code is 2B (area too 
small), the RPL field RECLEN 

or ARECLEN gives the length 
needed to hold the requested 
data, 


[a] Entry is from LU services rout- 
ing after an INQUIRE or INTER- 
PRET macro is issued in an 
application program or in net- 
work operator command handling. 
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CHAPTER 8. OPEN/CLOSE 


OPEN/CLOSE comprises four function groups; 

e OPEN and CLOSE access method control block 
e System services routing 

e FMCB handling 

e SRT handling 


An overview of OPEN/CLOSE operation is shown in MO 6. 


OPEN/CLOSE ACCESS METHOD CONTROL BLOCK (ACB) 


The OPEN/CLOSE ACB receives control from the system to process the 

opening or closing of a ACF/VTAM ACB. An OPEN or CLOSE ACB AMRU (access 

method RU) is built and passed to physical unit services to perform the 

ee unit services ae of the OFAN LOee.. ACB (Figures 8-1 and 
8-2). 


SYSTEM SERVICES ROUTING. 


= es 
() . ‘This function handles the end user requests and responses by setting up 
ae the proper interface and invoking the appropriate processor. SENDCMD, 


RECVCMD, and INQUIRE DISPLAY requests are passed to their respective 
processors. All other requests are passed in the form of RUPEs to the 
LUS manager. a are also passed to LUS. 


FMCB HANDLING 


The FMCB handler provides a macro interface (FMCBADD and FMCBDEL) to 
build and delete FMCBs. FMCBADD invokes procedures to build the EPT, 
DVTs, and FNCB. FMCBDEL releases what FMCBADD builds. 


SRT HANDLING 


; SRT handling provides a macro interface for adding SRT entries and for 
finding and optionally deleting SRT entries for specific symbolic names. 
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Application inecieas : ACF/VTAM: Operating System: | | | : \ 
Daal 
—— ree — 
Issues — | System Common | | 
— | Open Processor ; 


f ‘ 
OPEN/CLOSE (Open Application) Associates OPEN. 
"macro with. 


’ Establishes interface to system 


ACF/VTAM. 


_. attachment routines. bs 
@ Makes sure that ACF/VTAM is 
active. 
@ Builds work area and dynamic PAB. 

| @ Validates application program ID : 


and password. 
@ Initializes control blocks to. run 
under PSS control. 


Process Scheduling Services 


e Gives control to open appili- 
cation asynchronous phase as 
a result of the TPQUE macro 
issued by open application. 
_@ Ensures that ROT can be 
updated under protection of locks, 
if TPLOCK macro is issued By 
open application. 


System Definition (Alert Handling) 
Finds application program ROT 
"entry in active ROT segment. 


OPEN/CLOSE (Open Application) 


e@ Initializes application program 
ROT entry to indicate application 
program is open and active. 

@ Releases locks. . 

e Initializes control blocks needed 
for active application program 
(for example, application 
program LUCB, ACB, and. 

ACDEB). 


Application Program 


System Common . 
Open Processor . 


| 
- 


Figure 8-1. Processing an OPEN Macro Instruction 


Licensed Material—Property of 1BM 


92 


Ser TE HE BER OTE NDE ES TENOR TE COOGEE PONE TRNAS MAE TNS SERENA DATE MEIC RY REET aT RAE MATAR AN OT EE Re RON Cone eee sree 
BES Be TE ee a OGRE fo uEEN Paget $ a ei eee ae ae es ai Pogie naet we 


aI EAS EN AO ES RE TRH TREN LIT aN LT LTE MT TLE IE TE CETTE I TS IS EAR NI EIN, ACM HOE PE EIS PONE PRR TIRE REE 


sented Tite SalbeanF Tek Bie sabe teatbaen USB ES tae DL aa oe ae eet at Rat Lh aaa inaia anand st Lie elt 


selena 6S na ne as lin eB Bann ipnnen Mad ata nih Sa ha a Bina ie na atte hee ished BY 
( ‘ Application Program ACF/VTAM 


. ee , Application Program API (User Request Handling) 


issues OPNDST 
macro. 


@ Determines that request type is 
OPNDST. 
e@ Calls open destination routines. 


| OPEN CLOSE Routing 
| fae ee 


| ©. Verifies that ACE/VTAMisnot. | 
“halting. | 


_@. If SIMLOGON with logon data: 
was requested , moves logon 
date to system buffers... - 
@. Gets ROT entry for node being: - 
operand, using SRT Find. : 
«a 


OPEN/CLOSE (SRT Handling) 


| @ Finds SRT entry using symbolic 
name. 
© Returns.address of ROT entry. 


LUS 


@ Verifies that node being opened 
"gan be opened (for example, it 
is online, and has na VARY 
pending).. 


| 
Connects destination node to 
‘application program by building. ~~ 
stubs and chaining them to. the: 
ROT entries for the application 
program and destination node. 


me . —— 


OPEN/CLOSE (Open Destination) [. 


For Switched logical units 
| @ If not connected, SSCP is invoked 
to do a “dial out’’ operation. ; 4 
@ Receives control back when dial 
operation is completed. 


| OPEN/CLOSE FMCBADD | 


@ Builds real OVTs and entry point: 
table from skeleton OVTs to 
‘TSC support for the session. - 

@ Resolves BHSET ID and.user: 
processing options for the 

' connections. - 

- Builds and connects FMCBs to 
node. control biocks (NCBs) or 
LUCBs needed for the 
cannection. 

@ Resolves names from entry point 

_ table to OVTs. 

@ Initializes the TSC PABs with the 
resoived OVT pointers. 


@ Forms communication 10 (CID) 
' .. and places it in FMC8,NCB, 
and system tabie. 
@ Chains LUCB to ACDEB. 


LUS 


Binds application programs to 
logical units. ‘ 
@ Fills in user's NIBs for established 
"sessions. 

Releases locks; sets return codes, . 


- OPEN/CLOSE (Routine End) 
Releases storage for dynamic : 
PAB and work element. 


TPEXIT to PSS | 


Figure 8-2. Processing an OPNDST Macro 
: Instruction 
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MO 6. OPEN/CLOSE 


Input 


OPEN ACB 
Macro 
Instruction 


CLOSE ACB 
Macro 
Instruction 


Processing 


Connect the application 
program to ACF/VTAM. 


Terminate ACF/VTAM ser~ 
vices for this applica-~ 
tion program. 
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CHAPTER 9. APPLICATION PROGRAM INTERFACE (API) 
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= The collection of ACF/VTAM routines that initially handle Input/Output 
(I/0) requests from application programs is called the application 
program interface (API). 


When the API receives a request from an application program (in the fors 
of a macro instruction), it interprets the macro instruction and passes 
it (as an RPL) to TSC or OPEN/CLOSE. After the request has been trans~ 
: mitted to the destination node, the API receives feedback information 
from TSC or OPEN/CLOSE and checks that the operation has been completed 
successfully. The API then returns the feedback information to the 
application prograg. : | 


An overview of API operation is shown in MO 7. API synchronous process= 
ing is shown in Figure 9-1. API asynchronous processing is shown in 
Figure 9-2. 7 | | 


TSC or 
Application Program _ Application Program Interface | OPEN/CLOSE 


ch aituierobaccllte Toes User Request Handling ag | 
sonia O request | | @ Validates request type. If invalid request (not an ae 
: RPL ACF/VTAM macro), or a check on an inactive RPL, 


or macro request (other than CHECK) on active RPL, 
LERAD 
Exit Routine | 


or invalid eddress for ECB of invalid control block, 
invokes LERAD exit routine, 

* @ Puts reqUest type in RPL. 

e Passes RPL to TSC or OPEN/CLOSE. 


| ner Check Handling = sd ee | User Check Handling 7 if ae Process 4 
= Perce i/O Request 
-_ Waits for completion of the I/O. 


User Request Feedback Handling i 


Posts ECB | Posts user's ECB or posts an ECB in the RPL if user | Posts RPL 
did not specify an ECB address. , 


User Check Handling | 


e@ Examines RPL for completion status. 

@ In case of error, schedules user's LERAD or 
SYNAD exit routine. 

@ Returns to application program's next sequential 

instruction. 


LERAD. or SYNAD 
Exit Routine = 
| Application Program 


Figure 9-l.. API Synchronous Processing 
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TSC or 
Application Program Application Program Interface OPEN/CLOSE | pie 


Application Program 


Issues I/O request 
macro 
~ LERAD 

Exit Routine 


e Validates user request type. If invalid request (not an 
ACF/VTAM macro), or a check on an inactive RPL, or 
macro request (other than CHECK) on active RPL, or 
invalid address for ECB or exit routine, or invalid 
control block, invokes LERAD exit routine. 

@ Puts request type in RPL. 

e Passes RPL to. TSC or OPEN/CLOSE. 


e@ Returns to application program. 


RPL 


a a am oof 


Processes 


1/O Request 


~ 1/0 Complete 


ieee User Request Feedback Handling : : 
. Posts RPL . 
e@ Posts user's. ECB, = 
ae ae 
. @ Passes control to RPL exit routine. 


User Request Handling 


e Validates request type (of CHECK macro). 
@ Passes control to user check handling routine. 


~ User Check Handling ae 


@ If ECB was posted, clears out ECB; 
otherwise waits. | 

eo. If EXIT was specified, ensures exit routine hes 
already been scheduled. Otherwise, invokes 
LERAD exit routine. - 

@ Examines RPL feedback for completiar-status. 

@ In case of error, schedules user's LERAD or SYNAD 


routine, 
eee el ° 


a @ Returns to application program. — a . 


Exit Routine 


LERAD or SYNAD 
Exit Routine 


Figure 9-2. API Asynchronous Processing 


EXIT ROUTINE FACILITIES 


Exit routines are special interfaces between an application program and 
ACF/VTAM. These routines enable the application program to receive 
information from ACF/VTAM and respond to it. Exit routines do such | 5 
things as receive logon requests (LOGON exit routine), notify an appli- 

cation program that contact with the other end of a session has been 

lost (LOSTERM exit routine), or notify the application program that 

ACF/VTAM's services are no longer available (TPEND exit routine). These 

exit routines are coded as part of the program they serve, but operate 
asynchronously; that is, they are driven by events that interrupt and ; 
occur in parallel with main line application programs. These routines 

enable an application program to order that a certain task be done and 

then continue with its own processing while the exit routine is handling 

the specific task. 
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EXLST EXIT ROUTINES 


The application program can use the EXLST macro instruction to identify 
a variety of exit routines that ACF/VTAM schedules when particular 
events occur: 


ED EP ED ED GED GED ED ED ED ED ED ED GED ED ED EE Ds GES EE ED GE Es ED ED ED ED SD SEP SE OD OE EP GD OD GD SE SD OD OD ED SDP OP SD GD SD OP OE CP SD OD SD GPG OD GD SD GP GD OD OD GD OD 6 GD CD OD © OD aE aD? GP a 


Exit 
Event Routine 
A logon has been received from or has been LOGON 
entered on behalf of a logical unit, and the 
logon is waiting to be processed. 
A session with a logical unit has been LOSTERS 
temporarily interrupted or permanently lost, . 
the logical unit has reguested that the session 
be terminated, or an event has occurred that 
might affect future operation of the session. 
A session with a logical unit has been broken NSEXIT 
because of a session outage, or a session 

that is partially established cannot be 

fully established. 
A logical unit already in session is RELREQ 
wanted by another application program. 
ACF/VTAM is being shut down. TPEND 
The application program has | made LERAD 
an invalid request. | | 
A physical error has occurred during a , : SYHAD 4 
session establishment or I/O operation. | 
A special type of input has arrived fron DFASY 
a logical unit (the types of input are RESP 
discussed later). a. Be SCIP 


When one of these events occurs, the execution of the application 
program is interrupted, and the appropriate exit routine is given 
control. If another event occurs while the exit routine is being 
executed, the next exit routine is not invoked until the first has 
completed execution (this applies as well for RPL exit routines). 


Unlike accounting, authorization, and logon-interpret exit routines, 
which are included as part of the system during ACF/VTAM definition, the 
EXLST exit routines are included as part of the application prograr. 
The addresses of these routines are placed in an EXLST control block by 
the application progran. 


Each exit routine is scheduled by changing the program information block 
(PIB) save area address. Any processing in the routine that places the 
routine in a wait state should be used with caution, because the appli- 
cation program's entire task waits while the exit routine waits. Exit 
routines other than the LERAD and SYNAD exit routines must be reentera- 
ble only if two or more application programs share the same exit routine. 


Licensed Material—Property of IBM 


Chapter 9. Application Program Interface (API) 97 


I I NR TE TT SE Le TATE ICE TE CT LC TE TATE LE HES REE GENO 


MO 7 (Part 1 of 2). Application Program Interface (AP!) 


Input Processing Output , eG 
Call by Ne 
application on 
program macro 
instruction 
expansion. 

Ce eee Validate request. Pass 
all requests except CHECK 
aaa to appropriate ACF/VTAM. 
component 
be : 
‘ 


TPQUE- Process 
Scheduling 
Services (M09) 


For asynchronous requests 


Application 
Program NSI 


For synchronous: requests {MO 7=- 02. 
and CHECK requests 7 


Call | 
from TSC 
or OPEN/ 


CLOSE. 


02 Post. feedback in RPL. or 
ECB, or generate and 

schedule UECB for user 

asynchronous exit routine 


[o3] Valid input request: code are: 
*x'02" CHECK (OS/VS° only) - 
x'14" CHECK (DOS/VSE only) 
x'1S' SETLOGON 
x'16' SIMLOGON 

x'17" OPNDST 
x'1lA* INQUIRE. 
x'1B' INTERPRET 
x'1lF' CLSDST 
x'22* SEND _ 
x'23' RECEIVE 
x'24' RESETSR 
x'25' SESSIONC 
x'27' SENDCMD 
x'28' REVCMD 
x'29° REQSESS 
x'2A' OPNSEC 
x'2C* TERMSESS 
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MO 7 (Part 2 of 2). Application Program Interface (AP!) 


( ‘ Input ~ Processing Output 
Ne . n 


ae FROM 
nsere MO7=- 01 
Step~-1 
ae: Retrieve feedback on 
request checked for and aemenentesen aa ee Eo aemnian 
present to user as Register 0 
follows: 
a. For error conditions, _ 
call LERAD or SYNAD Register 15 
routine. Tg ee ge Oe SHE 
° Then, if no LERAD or SYNAD 
routine exists: 
* 


Be lexeetaee 
NSI after 
CHECK or 


synchronous 
request 


b. If request is completed Register 0 Register 15 


successfully: {| 


NSI after 
CHECK or H 


synchronous. 
request 
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CHAPTER 10. TRANSMISSION SUBSYSTEM COMPONENT (TSC) 
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The transmission subsystem component (TSC) provides a mechanism for 
information exchange between network addressable units (NAUS). The NAUs 

° Supported by ACF/VTAM are logical units, physical units, and the syste 
services control point (SSCP). A request for data transfer can be 
passed to the TSC from the application program interface (API), LUS, the 
SSCP, PUS, or the system I/O supervisor (IOS). Data can be routed 

‘ through the TSC to an application program (by the API or LUS), the SSCP, 
PUS, or a Communication device (by IOS). 


The TSC consists of nine functional groups, as follows: 


1. ACF/VTAM environment routes control to the proper part of the TSC 
and performs TSC control block initialization. 


2. Presentation services checks the validity of user requests and 
| converts requests and responses from the form used by the TSC into 
the form used by outside components. 


3. Function management data function interpreter builds message units 
suitable for the type. of logical. unit to which the message is 
destined. See Chapter 1. | ) 


4. Data flow control galidates the data flow protocols. ” 


_ | 5. Transmission control builds the transmission header of the path 
: information unit. (PIU), which controls the flow of data through the 
network, and does SNA state checks. | 4 


6. Path control selects the path and routes information (within TSC) 


to the next node in the path. It also does the boundary function. 


7. Boundary and transform functions establish sessions that flow 
through the boundary node, handles pacing between the primary 
logical unit and the boundary mode, handles pacing between the 
boundary mode and the secondary logical unit, maintains the state 
of all the sessions flowing through the boundary node, and provides 
support for non-SNA terginals. 


8. Data link control interfaces with the system I/O supervisor, which 
- controls the physical I/0 paths to communication devices. 


9. Presentation services converts input data to the format required by 
the other components, interfaces between TSC and the application 
program interface (API), and provides for transmitting data fron 
TSC to the SSCP and TOLTEP. 


An overview of the operation of TSC is shown in MO 8. 
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MO 8 (Part 1 of 5). Transmission Subsystem Component (TSC) | 
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Register 1 


The ACF/VTAM: environment func- 
tion group sets up the environ- 
ment used within TSC. It 
establishes a: standard TSC 


‘parameter list, and routes. 


control to the proper section 


of TSC to process the particular 


request. 


Having its own parameter list 
allows TSC to remain independent 
of changes to the major ACF/VTAM 
I/O control blocks (like the 
FMCB). The TSC status areas 

are actually contained within 
the control block structure 
under which TSC is running. 
However, only the environment 
function group has to change if 
one of these control blocks is 
redefined. 


Input that originates from an 
application program is passed 
to TSC in an RPL. Input from 
other ACF/VTAM subcomponents 

is passed to TSC in a trans- 
mission subsystem control block 
(TSCB). 


The presentation services func- 


tion group provides the interface 


between the TSC and the applica- 
tion program interface (API). 
This includes converting API 
requests (RPLs) into a format 
that is acceptable to the rest 
of the TSC (TSCBs). 


WH 


OES TTI a ET 


From API, 
SSCP, LUS, or 
TOLTEP 


Processing 


ACF/VTAM environment 


function group. 


@ Establish the environ~- 
- ment under which TSC 
runs. 


For nonapplication 
FM data: 


For nonapplication 
Data flow control: 


For nonapplication 
session control: 


For network control: 


Presentation services 


function group 


. ®@ Convert SEND and 
SESSIONC requests to 
the form required by 
TSC. . 


‘@ Construct an RU. hee a 
data flow. control or 
session control request 
(or response). 

x ‘ a= 
For data flow control 


For session control: | 
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Completed 
with 
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Input RPL or 
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MO 8 (Part 2 of 5). Transmission Subsystem Component (TSC) 


Input 


The FM data function interpreter 
function group provides function 
Management for an application 
program. 


It also provides function manage 
ment for the SSCP. This includes 
processing for selected network 
services requests. 


The data flow control (DFC) func- 
tion group provides the various 
data flow control protocols 
available to NAUs. The DFC 
function group monitors all 
information flowing from (and 
to) an application program. 


The transmission control (TC) 
function group controls all data 
flowing through the telecommuni- 
cations network. TC provides a 
set of well-defined data flows, 
control functions, and protocols 
which enable a network address- 
able unit (NAU) to communicate 

- through the network to another 
NAU. 


A host application program NAU 

is capable of supporting multiple 
sessions with other NAUs in the 
network. TC uniquely identifies 
and maintains the integrity of 
each session using pairs of 
network addresses. One network 
address identifies each NAU; a 
pair of network addresses, 
therefore, uniquely identifies 


Processing 


Output 


Function management data 
function interpreter 
function group 


e Perform function 
management for an 
application program or 
the SSCP. 
Fixed 


buffer(s) _ 


e Move user's data to 
fixed buffer(s). 


.Data flow control function 


group 


@ Monitor data flow 
control protocol usage. 


Transmission control 
function group 


e Process session control 
requests and responses. 


Process network control 
requests and responses. 


‘Control all transmis- 
sions during a session. 


the session that is established 
between the two NAUs. 


Transmission control consists of 
three sections: 


@ Session control provides the 
NAU with functions for control- 
ling the operation of its 
sessions. 


Network control provides trans- 

- Mission control and path 
control with administrative 
functions. 


The connection point manager 
(CPM) controls the transmission 
of requests and responses dur=- 
ing the session, including 
those generated by session con- 
trol and network control. 
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MO 8 (Part 3 of 5). Transmission Subsystem Component (TSC) 
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The path control (PC) function 
group routes information from a 
sending connection point manager 
(CPM) to a receiving CPM. Path 
control selects the communica- 
tions path, and all communica- 
tion between CPMs is kept path- 
independent. 


‘Path control allows. communica- 


tions between CPMs that reside 
in the same host (application 
program to application program), 
between CPMs that reside in the 
same domain (application program 
to logical unit in the same 
domain), and between CPMs that 
reside in different domains 
(application program to logical 
unit or application program in 
a different domain). 


The path selected by path contro 
may consist of several inter- 
connecting links and associated 
nodes. The transmission header 
(TH) is used to pass control 
information from the sending 
path control to the receiving 
path control, and to all inter~ 
mediate path controls that are 
in the selected path. 


The boundary and transform 
functions function group per- 
forms the boundary functions 
for a locally attached cluster 
controller (PU type 2). 


- @ Route information to 


os Ee] 


© For POST=SCHED, post ———- 
the request as com- 7 


Processing Output 


Path control function 
group 


proper path control 
element. 


For CPM in same host: eae: 2) 
For CPM not in PU : 


Boundary and transform 
functions function group 


e@ Perform boundary . 
' function transmission 
control function. 


@ Perform boundary | 
function path control 
function. 


Data link control function 
group 


@ Schedule I/O request to 
send the data to the 
next data link control 
in the selected path. 


To I/0 To Telecommunications 


Presentation services Supervisor Controller or Terminal 


function group 


pleted: To API, SSCP, 
or OPEN/CLOSE 


@ For POST=RESP, save tdie = 


request until response 
is received. cea 
To Process 


Scheduling 
Services . 


Boundary function transmission 
control consists of the follow- 
ing sections: 


e Boundary function common ses~- 
sion control (BF.CSC) estab- 
lishes sessions that flow 
through the boundary node. 


Boundary function connection 
point manager (BF.CPM) handles 
pacing between the PLU_and. the. 
‘boundary node, and between the 
boundary node and the SLU. 


Boundary function session con- 
trol function interpreter 
(BF.SC.FI) maintains the state 
of all sessions flowing through 
the boundary node. 


This function group also pro- 
vides support for non-SNA dis- 
play terminals by converting . 
all outbound SNA requests into 
the appropriate series of FIDO 
BTUs. 


The data link control (DLC) func- 
tion group manages the communi- 
cations links. These include the 
data links to locally attached 
communications controllers, 
locally attached cluster control- 
lers, and locally attached dis- 
play terminals. 


DLC provides the interface be- 
tween the host operating system. 
I/O supervisor and path control. 
It constructs and schedules 
channel programs. 
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( s Input Processing Output 
Nee (ake a: Data link control func- 
tion group 
From I/O 
Supervisor 


e Analyze status of I/O 
operation. 


Path control function 
group 


Fixed buffer (s) 


@ Deblock inbound data 
into PIUs, and build 
TSCBs at the beginning ; 
of each input buffer. 


Perform boundary func- 
tions (if necessary) . 


From Telecommunications 
Controller or Terminal 


Boundary and 
Transform 
Functions 
Function Group 


Route information to 
proper path control 
element. 


a. ACF/VTAM environment 


function group 


ae @ Establish the environ- 


ment under which TSC 
runs. 


Register 1 


For a RECEIVE or 
RESETSR request: TSPTSCB TSCB or RPL 


Status areas 


Path control function 


“group 
@ Assemble segmented BIUs. 


The data link control (DLC) 
function group manages the 
communications links. These 
include the data links to 
locally attached communications 
controllers, locally attached 
cluster controllers, and locally 
attached display terminals. 


DLC provides the interface 
between the host operating 
system I/O supervisor and path 
control. It analyzes the status 
whenever a channel program ends. 


The path control (PC) function 
group routes information from a 
sending connection point manager 


(CPM) to a receiving CPM. Path 
control selects the communica- 
tions path and all communication 
between CPMs is kept path- 
independent. 
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Transmission control consists of 
three sections: 


e Session control provides the 
NAU with functions for control- 
ling the operation of its 
sessions. 


Network control provides trans- 
mission control and path con- 
trol with administrative 
functions. 


The connection point manager 
(CPM) controls the transmis~- 
sion of requests and responses 
during the session, including 
those generated by session 
control and network control. 


The data flow control (DFC) 
function group provides the 
various data flow control 
protocols available to NAUs. 

The DFC function group monitors 
all information flowing from 
(and to) an application program. 


The FM data function interpreter 
function group provides function 
management for an application 
program. 


It also provides function manage- 
ment for the SSCP. This includes 
processing for selected network 
services requests. 


A set of routines called process scheduling services (PSS) provides 
queuing, scheduling, and dispatching services to allow ACF/VTAM processes 
~ to control the flow of requests. They also provide locking services 

and establish a recovery environment. 


An overview of PSS operation is shown in MO 9. 


PSS MACRO INSTRUCTIONS 


A set of macro instructions is used to invoke and ccntrol PSS opera- 
tions. These macro instructions are used only in ACF/VTAM routines; 
they are not available for use in application programs. The PSS macro 
instructions are: 


e TPQUE: Adds a work element to a queue or a PAB and optionally 
schedules the process represented by the PAB to be dispatched. 


e TPDEQ: Removes a work element from a queue or a PAB. 
e TPSCHED: Schedules for execution a process represented by a PAB. 


e TPEXIT: Indicates that a process has terminated and the PAB canbe 
rescheduled. 


® TPESC: Transfers control to the next routine indicated by the DVT. 


e TPWAIT: Suspends execution of the issuing process. * 


e TPPOST: Schedules a process to resume execution at the instruction 
after the TPWAIT. 


e TPLOCK: Obtains shared or exclusive ownership of a lock or queues 
' the request if a lock cannot be obtained immediately. | 


e TPUNLOCK: Releases ownership of a lock and, if the lock is now free, 
processes any queued lock requests. 


® TPDVTS: Changes the list of processes located by the DVT. 

e  fTPFEL: Locates the oldest work element on a queue. _ 

e ACTAP: Schedules PSS to receive control asynchronously. 

e APSINIT: Allocates and initializes PSS control blocks. 

e APSTERM: Releases PSS control blocks when they are no longer needed. 


e TPIO: Used by API to inform ACF/VTAM of an application program 
request. 


e TPSTAE: Creates, changes, or removes a STAE recovery environment 
(OS/VS1). 


Licensed Material—Property of IBM 


Chapter 11. Process Scheduling Services (PSS) 107 


1a once Veet et Leet gE topper separ eae S . PIE MR oye en eng poem = cee anteie EN _ ow aN Ue aoe _— award eae 
a SESS ee PED aan § Eee Pig agk yee Gace ee Se, ET eg eer ee ee Ser er Pera eT TEE BOE RENE SA 8 A PE REET SEE OLE AY PONE ITE IE AEG IES TI AO ATE NE Oe RE AR ORM eM pe I Se ee toe 


EET ER A TT LEM TIER ETE I ESET ER CTO SEPT EYE ETON Es siete 


Since ACF/VTAM routines run in supervisor state and under the ACF/VTAM 
protection key, an SVC interface is required for the application program 
interface to initiate a request. This SVC is made system-independent by 
its inclusion within the expansion of the TPIO macro instruction. 


The TPIO macro instruction causes an SVC state ana protection key 
change. Within the SVC routine, a TPQUE and TPSCHED are executed to 
initiate the processing required for the request. 


CE CONTROL 


RED ome nD REED <A ceRD dee eR en NCE 


The execution sequence control routine provides linkage to a set of 
sequential processes. These processes are pointed to by entries in the 
destination vector table (DVT). Each DVT has a name that is located in 
the DVT entry point table (EPT). A DVT entry represents a routine, and. 
many DVT entries make up a level of the system. The entry point table 
and corresponding DVT entries are constructed during the binding process 
from a skeleton DVT, and they determine the Sequence in which routines 
process requests flowing rarouge Bonceeees 


s of Execution Seguence Control 


The operation of the execution sequence control*routine is governed 
either by parameters received when it is called or by information in the 
entry point table or in the real DVT. 


The execution sequence control routine transfers control in one of two 
ways, depending on the type of call used to enter the sequence control 
routine: : 


Next Process: Control is given to the routine whose address is in the 
DVT entry pointed to by the RPH. The pointer in the RPH is then updated 
to indicate the next DVT entry, that is, the entry for the next routine 
that is to be executed in processing this DVT. 


Named DVT: When entry is made with this type of call,:.the name passed is 


resolved into a DVT pointer through the entry point table. Control is 
then passed to the first entry in that DVT. A pointer to the next entry 
in the DVT is saved in the RPH. 


PSS routines schedule the execution of other ACF/VTAM routines that are 
pointed to by the DVT, thus enabling ACF/VTAM to schedule its operation 
independently of the operating sytem dispatcher. See "Scheduling an 
ACF/VTAM Process" in Chapter 2. | | : 


PSS scheduling and dispatching routines are system-dependent. For a 
description of their operation in each systen, see ACF/VTAM Logic. 


Since ACF/VTAM offers a high degree of parallel and asynchronous opera- 
tion, special attention must be paid to serializing ACF/VTAM's internal 
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use of shared resources. The mechanism used to accomplish this seriali-~ 
. zation, the lock structure, is an internal function and is not visible 
( \ . to the user. The locking method used is to set locks on all the code 
\ that causes the updates (rather than setting locks individually on each 
resource to be updated). This method prevents lockout when waiting for 
several resources (that is, a task causing itself to be locked out of a 
resource while it waits for es For a description of the locations and 


Classes of Lock Holders 


There are two classes of lock holders: 


Shared: When a lock is obtained as shared, the obtainer can only read 
the resource. Any number of programs can hold a shared lock ona 
resource at the same time. 


Exclusive: When a lock is obtained as exclusive, no other program can 
oktain the lock (either shared or exclusive) on the resource until the 
exclusive lock holder releases it. To change or delete a resource, a 
program must hold an exclusive lock on it. 


Access to Locks 


Access is controlled as follows: 


@ A eoquest to share a lock that is free or already shared. (with no 
outstanding exclusive tequests) is honored immediately. 


\ | 
q e A request for exclusive control of a lock that is already held is 
| queued until all programs sharing the lock release it. fhe request 
is then honored. 


@ Any request for a lock that is held as exclusive or has an exclusive 
request outstanding is queued until the exclusive use is completed. 


e Wait requests are handled in a first-in, first-out order. 
Locking Hierarchies. 


All ACF/VTAM locks are allocated according to a predetermined hierarchy. 

' This means that a program holding one lock cannot obtain a lock that is 
higher in the hierarchy without first releasing the lower one. Strict 
enforcement of this hierarchy prevents any possibility of a deadlock, in 
which two programs each hold a lock and are queued for the lock held by. 
the other pxcogran. 
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Input 


—— 


! + Lockword 


Control 
Block 


Lock 
Indicator 


TPLOCK Macro 


Instruction 


TPUNLOCK Macro 


Instruction 


[ 


TPQUE Macro 
Instruction 


Ea 


“TPDEQ or TPFEL 


Macro. 
Instruction 


Processing 


1] Control serialization of 


resources by managing 
locks: 


a. Set lock level held, 


and lock the resource. 


If the lock cannot be 
obtained immediately, 
queue the requester's 
RPH and issued: TPWAIT. 


Reduce the number of 
owners. Unlock and 
TPPOST waiters if the 
caller is the only 
user. 


‘Handle work element 
queues: 


a. Compare and swap the 


work element to the 
queue on the anchor. 


Locate the element. 
Dequeue the element 
(for TPDEQ) or return 
the element address 
(for TPFEL) . 


To 
Caller 


Output 


Control 
Block 


Requester's 
RPH 
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Input 


e. If the TPDVTS macro instruc- 
tion specifies “no return," 
a TPESC macro instruction is 
issued to advance the RPH 
pointer to the next process 

in the DVT. Otherwise, re- 

turn is made to the caller. 


Processing Output 


ae. Provide scheduling 
services. 


TPPOST Macro 
Instruction 


a. Schedule process 
to be dispatched 
to resume address. 


Put the resume address 
in the RPH. 


TPWAIT Macro 
Instruction 


Clear the PAB if 
possible; reschedule 
TPEXIT Macro the PAB if indicated. 


Instruction 


Caller 


to the next process in 
TPESC Macro DVT. Call the process, 
Instruction 
TPEXIT to 


Dispatching 


Find the symbolic name 
passed in the entry 
point table. Update 
the DVT pointer in the 
RPH. 


TPDVTS Macro 
Instruction 


Note 03e 
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Input 


Work to dispatch can be: 
A 


112 


@ Posted Process 
e@ Scheduled PAB 
e User exit 


For PABs, locate an RPH to use. 
If continuing after TPEXIIT, 
reuse the RPH. The next choice 
is the preallocated RPH in the 
APT or PST. If neither is 
available, issue REQSTORE for 
LPBUF. 


User exit address must be 
validated; it comes from the 
RPL or ACB. 


Return from the dispatched 
process is by TPEXIT or TPWAIT 
for ACF/VTAM processes, or on 
register 14 for user exits. 


TPIO Macro 
Instruction 


TPQUE Macro 
Instruction 


TPSCHED Macro 
Instruction 


From System 
Dispatcher 


Processing 


processes. 


the reset queue. 


the DVT. 


Dispatch process: 


dispatch the PAB. 


Licensed Material—Property of IBM 


Schedule asynchronous 


a. Locate the PAB address. 
Issue an SVC to per- 
form the processing. 


b. Compare and swap the 
work element to the 
PAB. If reset, queue 
the work element to 


Schedule the PAB to be 
dispatched at the first 
routine pointed to by 


Select work to dispatch; 


Next 
Sequential 


Instruction 


To 
Caller 


See Note 05 


Output 
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CHAPTER 12. STORAGE MANAGEMENT SERVICES (SMS) 


Storage management services provide storage services to all ACF/VTAM 
components by allocating or deallocating buffers. These services are 
provided only for ACF/VTAM components; they are not available to appli- 
cation programs. 


An overview of storage management services is shown in MO 10. 


To obtain the services, ACF/VTAM components use internal macro instruc- 
tions (described below). The macro instructions and return codes are 

’ the same for all components. In addition, the macro and return codes 
are the same for components in the DOS/VSE and OS/VS versions of 
ACF/VTAM. The interface to ACF/VTAM routines is common across all 
operating systems; however, the internal coding of the storage manage- 
ment service routines is different because of differences in the systen. 
For example, in DOS/VSE, buffer pools are constructed during ACF/VTAM 
initialization by issuing the GETVIS macro; in OS/VS, the GETMAIN macro 
is issued to get storage. 


Storage management services provide all ACF/VTAM components with. fixed- 
length buffer pools. Separate pools are maintained for fixed-storage 
and pageable-storage buffers. In addition to the fixed-length buffer 
services, the GETSTOR or VTALLOC and FREESTOR or VTFREE macro instruc- 
tions provide a limited "contiguous storage area" service. 


A buffer-pool directory, pointed to by the ATCVT, contains an entry for 


ae each pool. The entry points to a chain of the buffers assigned to that 
O pool and indicates whether the buffers are available for allocation. 


LD LEPESANT > a ap ae Ee ee ED ame epEED CORES 


Each ACF/VTAM fixed-length buffer pool can be expanded when the demand 
for buffers from the pool exceeds the current supply of available | 
buffers. Conversely, the expanded portions of an ACF/VTAM buffer pool 
are freed when the extra buffers are no longer needed. 


Dynamic expansion of buffer pools can be controlled by ACF/VTAM start 
options. These start options can specify an expansion threshold parane- 
ter and an expansion size parameter. The pool expansion threshold 
parameter is used to determine when to expand a buffer pool. When the 
2 number of available buffers in a pool reaches or drops below its expan- 
Sion threshold value, the pool is scheduled for expansion. The expan- 
sion size parameter indicates the number of buffers by which a pool is 
to be increased whenever expansion is necessary. Space for pool expan- 
sions is obtained in page-size increments, the amount obtained being the 
number of pages needed to supply the specified number of buffers. | 
Storage management services calculates a contraction threshold value for 
each buffer pool. When the number of available buffers in a pool 
reaches or exceeds this threshold, extents that are not in use are 
scheduled to be freed. The contraction threshold value equals the 
expansion threshold value, plus the number of buffers in two extents. 


STORAGE MANAGEMENT MACRO INSTRUCTIONS 
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( . . There are two pool service macro instructions: BLDPOOL and DELPOOL. 
oad BLDPOOL enables an ACF/VTAM routine to build a buffer pool, while the 
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DELPOOL macro instruction enables a routine to delete it. Because only 
shared buffer pools (in which space is allocated for more than one type 
of buffer) are supported, these macro instructions are issued only in 
the initialization and termination routines. One BLDPOOL macro instruc- 
tion is included for each shared buffer pool in the initialization 
routine, and one corresponding DELPOOL macro instruction is included in 
the termination routine. 


Buffer service provides two macro instructions: REQSTORE and RELSTORE. 
These macro instructions enable ACF/VTAM routines to request or release 
fixed-length buffers from or to predefined buffer pools. 


Variable-length storage areas can be acquired and released with the 
GETSTOR or VTALLOC and FREESTOR or VTFREE macro instructions. 
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MO 10 (Part 1 of 2). Storage Management Services (SMS) 


( 2 Input Processing Output 
BLDPOOL Macro 


General Registers Buffer Pool Directory 


+ Buffer Pool 
+ Buffer Pool 


REQSTORE 
Macro 


Register 15 


02 | Obtain fixed-length Return 
buffers from the pool. [| Code 


General Registers 


RELSTORE 
Macro 


Pool Control Block 
Return fixed-length 
buffers to the pool. 


VTALLOC or 
GETSTOR Macro 


General Registers | RPH or Register 3 


es Lf Storage 


Return to 
FREESTOR Macro aller 


ocr routine | aber | ret. 
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MO 10 (Part 2 of 2). Storage Management Services (SMS) 


- ¢ | | a A | 
Input. Processing Output . ee /) 


General Registers 


Return to 
Caller 


Delete the buffer pool, 


and release storage. ae 


Buffer Pool Directory Return to 
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CHAPTER 13. RELIABILITY, AVAILABILITY, AND SERVICEABILITY 


(SOR) EES EES -a S SE? CEE RANEY EE ED RAPS SER RR? Gee ae GEE eu SINE epee A 


ACF/VTAM has two types of reliability, availability, and serviceability 
(RAS) aids, which enhance the usability of ACF/VTAM: 


® Serviceability aids, which assist in problem determination 


2 Reliability and availability aids, which enhance ones opera~ 
tion and performance 


An overview of the operation of RAS routines is shown in MO 11. 


SERVICEABILITY AIDS 


internal Trace 


The internal trace keeps a record of ACF/VTAM resource usage and flow of 
control. The trace is kept in the form of predefined 32-byte records 
that can be read in a dump of ACF/VTAM storage or, in OS/VS, in the 
output of the system general trace facility. 


Tracing Facility 


| aes om 


In addition to the internal trace, ACF/VTAM provides internal traces of 
buffers, buffer pools, I/O operations, and lines. Information on how to 
use these traces in each operating system is given in ACE/NIAS Diagno# 
tics. 


ACF/VTAM provides four types of traces: (1) buffer (specified in the 
start procedure and in MODIFY operator commands as BUF), (2) line 
(specified as LINE), (3) I/0 (10), and (4) buffer pool usage (SMS). 
This function takes place in three stages: | | | | 


@ Establishing and maintaining a trace environment in ACF/VTAM in 
response to operator commands. 


e Generating and writing trace records. In OS/VS, this is done in 
conjunction with the system general trace facility. 


e Formatting and printing trace information. In OS/VS, ACF/VTAM 
provides formatting for the system HMDPRDMP service. In DOS/VSE, 
ACF/VTAM both formats and prints the trace information. 


these types. ae addressable nodes: terminal component, logical unit 
(which can be a terminal), physical unit (cluster control unit), or NCP. 
A buffer trace is a means of identifying all changes to data caused by 
ACF/VTAM. As a message coming from or going to an application program 
enters ACF/VTAM control, it is placed in a trace record and written to 
auxiliary storage. Included in the record are the node name of the 
application program, the resource ID of the logical unit, and message 
data. 
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NCP Line frace: Operating parameters of a line are traced by the NCP 

line trace whenever a specified interruption level occurs. One line can Zo *, 
be traced at a time. If more than one line trace request is made, ae, 
additional requests are rejected until the preceding trace has ended. | ce 


I/O Trace: This trace collects information for a local or remote NCP or 
for remote devices attached to the NCP. The data collected is variable; 
it depends on the type of node being traced. 


Buffer Usage Trace: The ACF/VTAM buffer usage trace aids the user in 
determining a reasonable size for each of the 11 buffer pools. Periodi- 
cally, a trace record is created that identifies, for each pool, the 
number of elements in the pool, the number of currently unallocated 
elements, the maximum number of elements that were concurrently in use 
Since the last trace record was written, a maximum number of concurrently 
queued requests for buffers since the last trace record was written, 

the maximum number of elements in the pool since the last trace record 
was written, and the number of times the pool was expanded since the 

last trace record was written. 


Formatted Dump 


ACF/VTAM's formatted dump interacts with two different OS/VS components: 
AEDUMP and PRDMP. ABDUMP operates as part of the operating systen's 
abnormal termination (ABEND) procedure; ABDUMP selects the storage to be 
dumped and dumps it. PRDMP formats and prints the dump. 


Teleprocessing Online Test Executive Program_(TOLTEP) | | _ a 

| | aa ™ 
TOLTEP sonteois the selection, nang: and execution of online tests. Boas the ye - Nae 
(OLTS) within an ACF/VTAM system. An OLT is a specific device test 4 


designed to help diagnose a hardware problem or to verify the usability 
of a control unit or terminal. For more information about TOLTEP, see 
Chapter 18. 


Hardware Error Recording 


Error recording is a part of the error recovery procedures of the 
configuration services subcomponent. The error data is placed in the 
system error record file (SYSREC) for subsequent editing and printing. 
Error recording takes place under these conditions: 


® Permanent error: Errors that are either unrecoverable or errors fron 
which ACF/VTAM has failed to recover 


e Counter overflow: Written whenever the SIO (Start I/O) counter, the 
temporary error counter, or one of the device statistics table 
counters is about to overflow 


e End-of-day: Written whenever the terminal or line is brought offline 
(with a VARY INACT command) | 
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Software Error Handling in OS/VS 
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ir 


Patch Area 


A patch area is supplied as a separate phase (DOS/VSE) or load module 

(OS/VS). This area is used to insert short service programs or fixes. 
This patch area is a separate ACF/VTAM module whose size can be varied 
by the user with the use of link-edit facilities. 


Mapping of CSECTs,. Control Blocks, and Buffers 


Each ACF/VTAM CSECT contains information indicating the CSECT's name and 
its change level. The first byte of certain control blocks and buffers 
contains an identifier that is set when the control block or buffer is 
initialized. 


RELIABILITY AND AVAILABILITY AIDS 
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Hardware Error Recovery Procedures 


When an I/O error interruption occurs, device-dependent and 
control-unit-dependent error recovery procedures (ERPs) are invoked. 

The ERPs examine the channel status word and the sense data to determine 
the type of error and the action required to attempt recovery from the 
error. If the ERP cannot correct the error (that is, if the error is 
permanent), the ERP sends a message to the operator and records the | 
error in SYSREC. If the ERP corrects the error (that is, if the error 
is temporary), no operator Bessage is issued, and the temporary error 
counter is incremented. 


ACF/VTAM handles three types of software errors: 
e ACF/VTAM errors that occcur during application program processing 
e ACF/VTAM errors ‘that occur during task processing 


e Errors resulting from application program reguests for ACF/VTAM 
services 


For these types of errors, ACF/VTAM performs cleanup and recovery 
processing, dumps and records error condition information, and makes the 
appropriate entries in the ACF/VTAM audit trail. 


ess Recovery and Abend 


fe 


ndling (QS/VS) 


These facilities handle the initial recovery on an abnormal termination 
and dispatch recovery routines. If recovery is not attempted, or if it 
fails, abend handling ensures that resources allocated to ACF/VTAM are 

cleaned up. 
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Commands and Messages 


ACF/VTAM commands enable the operator to define the network's configura- 
tion and display its status. By using the commands, the operator can 
activate and deactivate nodes and change their attributes while the 
system is running. The command processing routines are supported by 
error messages and warning messages that notify the operator of the need 
for reconfiguration and report problems that occur during reconfigura- 
tion. | | 


- ‘Pesting the Logical Unit 
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The logical unit may be tested pee either ‘the Echo Test or the Link Level 5 
2 Test. | 


Echo Test: A logical unit to SSCP Echo Test allows a logical unit to 
test the connection between itself and the SSCP. Echo Test uses the 
Unformatted System Services (USS) function of the SSCP and provides the 
test for all logical units that support USS within the SSCP's domain. 


Echo test is initiated by the terminal operator and assures the operator 
that the communication link to the host system's SSCP is operable; 
however, the terminal's fath to an application program in a host system 
is not verified by Echo Test because of the possibility of a different 
path's being used for logical unit to application program sessions. 


Link Level 2 Test: The Link Level 2 Test provides the capability of 

testing a single or multiple secondary terminal and, at the same time, 
allowing other sessions on the same link to Continue operations. The om 
secondary terminal under test is dedicated to the test and is not ff ): 
available to network users until the test has been terminated. i SS 


All requests from the network operator and application programs are 
initially tested for errors. If an error is detected when the request 
is made, ACF/VTAM notifies the requester and rejects the request. Any 
processing done on behalf of the rejected request is cleaned up. Later, 
if an error condition is encountered during the processing of a request, 
ACF/VTAM notifies the reguester and stops processing the request. If 
possible, ACF/VTAM cleans up the processing that was done on behalf of 
the request. | 


Storage Reliabilit 


All ACF/VTAM routines, buffers, and control blocks (except user-defined 
ACBs, NIBs, and RPLS) reside in the ACF/VTAM partition or address space, 
which has its own storage protection key. The storage protection key 
prevents unauthorized user programs from using the ACF/VTAM partition or 
address space. In DOS/VSE systems, all ACF/VTAM routines, control 
blocks, and buffers reside in the ACF/VTAM partition, which has its own. 
storage protection key. In OS/VS systems, they are placed in the 
ACF/VTAM partition (OS/VS1), in address Space (OS/VS MVS), or in 
protected system areas. 


ACF/VTAM's storage management routines enable storage requests to be | a 
gueued if storage is not available at the time of the request. This cra 
queuing ensures that, once application program requests (such as SEND - 
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and RECEIVE) are initially accepted, they a 
rejected because storage is not immediately 


Lock 


ACF/VTAM has its own locking structure to enst 
require serial access are not used by more tha 
a time. A locking hierarchy is established to 
Situations and to reduce the amount of waiting 
are described in Chapter 14 and in ACF/VTAM Dia 


ACF/VTAM assigns sequence numbers to I/O requests 

numbers are maintained for inbound and outbound re 
programs can use these seguence numbers to correla 
reguests and to assist in analyzing the trace reco. 


ACF/VTAM requires a certain minimum number of buffer: 
the required number of buffers is not available, ACF, 
slowdown mode, whether ACF/VTAM has data to read or n 
program requests are not rejected; they are queued anc 
| after slowdown mode has ended. When enough buffers be 
| ‘for reads, ACF/VTAM ends the slowdown mode. 
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MO 11 (Part 1 of 4). Reliability, Availability, and Serviceability (RAS) 


Input _ : Processing Output 


From TSC 
through PSS 


Trace processing 


a. Perform I/O trace. 


. Trace Record 


Register 1 


b. Perform line trace. 


c. Perform buffer trace. 


From TSC 
(through 
PSS) 


RDT 


Generate internal 
records. 


d. 


INTRACE 
Macro 


TPEXIT 
or Return 
to Caller 


e. Print trace record 
(DOS/VSE only). 


Trace Record 


Trace Report 


d. In D08/VSE, the trace records 

can be printed either by the 
_ TPRINT utility in its own 

partition or as a subtask. 
In OS/vsS the general trace 
facility and the HMDPRDMP 
utility are used to format 
and print the trace records. 
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MO 11 (Part 2 of 4). Reliability, Availability, and Serviceability (RAS) 


é \ Input Processing Output 
x Add Macro - 
Control block queuing 
a. Add control blocks. 
Register 1 2 Queue Anchor Block 
b. Remove control blocks. 
Added Control Block 
Register 15 
n 0 = successful | 
15 = queue 
empty 
ee. Formatting and printing 
control blocks (OS/VS 


only) 


a. Format control block 


b. Print the records. : 
ABDUMP 
or 2 
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MO 11 (Part 3 of 4). Reliability, Availability, and Serviceability (RAS) 


Input _ Processing _ Output . A j 


System 
Recovery/ 
Termination 
Manager 


Process recovery (0S/VS 


only) 


a. If a retry is possible, 
set indicators for the 

system return control 

to the module in error. 


Otherwise, set indica- 
tors for the system to 
continue the abend 
(resulting in the 
ACF/VTAM resource re- 
covery manager's get- 
ting control). 


Resource recovery (O0S/VS 


only) 


System 
Recovery 
Termination 
Manager urea 

Clean up ACF/VTAM 
resources. 


Schedule the ACF/VTAM 
termination subtask 
PAB. 


PQUE Process 
Scheduling 
Services (MO 9) 
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MO 11 (Part 4 of 4). Reliability, Availability, and Serviceability (RAS) 


\ Input Processing Output 


From ACF/VTAM 
Resource 
Recovery 
Manager 
through TPQUE 
to PSS 


ACF/VTAM termination 


subtask (OS/VS only) 


System 
Recovery 
Termination 
anager 


Clean up resource being 
used by the application 
program that is in error. 
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CHAPTER 14. PHYSICAL UNIT SERVICES (PUS) 


EP CALI EE 


Physical unit services (PUS) is used to control network resources local 
to the host, for example: 


® Activate and deactivate local resources at SSCPs direction. 

® Process inoperative conditions for local resources. 

® Notify half-sessions within the host subarea of session failure on 
receipt of Lost Subareas RUs. 


An overview of the operation of PUS is shown in MO 12. 


ROU 


a | 
K 
= =) 
Q 


A REQUEST OR RESPONSE 


yas aSRawes «aiporin 


Physical unit services is dispatched on a single PAB, with its input 
being a request/response unit processing element (RUPE). 


PROCESSING ACCESS METHOD CLEANUP REQUESTS 


SSCP sends an Access Method Cleanup request to PUS when a line or. 
physical unit fails. PUS notifies the SSCP of the session reset of 
legical units (for the LUS that have sessions with application prograas) 
by issuing a Terminate Other Force Cleanup request. SSCP also sends 
Cleanup requests to PUS when a Cleanup request results from a forced 
deactivate command for a logical unit. PUS notifies any application 
program that is a primary end of a session involving a deactivated 4 
logical unit. It does this by issuing a Terminate Other Orderly (Clean- 
up) request to the session services subcomponent of SSCP. The session 
services subcomponent terminates the sessions. ; 


ROCESSING LOST SUBAREA REQUESTS 


ED CED OP — A PE cEgD CHa NE LP 


Lost Subarea requests can be received by PUS from other subarea nodes. 
PUS responds to the Lost Subarea request, if necessary, and calls systen 
definition, passing the network address of the subarea that is lost, or 
which sent the Lost Subarea request. System definition returns a list | 
of all the subareas that this domain might try to reach through the lost 
subarea. The list is made up from the matches found between the list 
received from the adjacent subarea and the list received from systen 
definition. Each logical unit that has a session with a logical unit in 
this lost subarea list (including the CDRM) is notified that the session 
is lost. This is done by sending to logical unit services a Lost Path 
request for each active or pending active LU-LU session on the list. 

For CDRM-to-CDRM sessions, the Lost Path request is sent directly to the 
CDRM, and an NSLSA is sent to the SSCP. 
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MO 12. Physical Unit Services (PUS) 


Input Processing . | Output 


‘PUS PAB - ATCPUPAB 


Route the RU. 


a. If a request, route 
the request to the 

appropriate request 
processor. 


Register 1 


If a response, route 
’ the response to the 
. appropriate response 


processor. 
Reject MBSURECERSS 
RUs. 
To PSS (MO 9) 


The Physical Unit Services , 
router determines what the in- . “~ “ : 
put Request/Response Unit (RU): i | : J 
is and routes to the appropri- 
ate processing routine. 
All unsupported RUs are rejected | 
with "function not supported." 
| | | oe 
att 
Oi ma ee ; 
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( ~ Logical unit services (LUS) provides support for logical units in this 
domain by: 


e Establishing and terminating sessions between an application prograa 

and other logical units. This processing is performed by the 

: Open nest snare on and close-destination routines. 

2 e Providing the logical unit function for terminal systems that do not 
provide their own LU function. 


e Handling and processing end user requests, LU-LU session requests, 
. function management requests, and unformatted requests. End user 
requests and LU-LU session requests are routed to the LUS manager 
for processing. Function management RUs, which flow on the SSCP-to- 
LU session, are sent to the function interpreter for processing. 
Unformatted requests are passed on to the operator. 


e Handling Lost Path, Cleanup, and Notify request units (RUs). These 
RUS are sent to LU services and then forwarded to the application 
programs affected. The RUs are used to notify the application 
programs of path errors so that sessions can be terminated in an 
orderly manner. 


This component also handles INQUIRE and INTRPRET macro instructions 
issued in application programs or by ACF/VTAM itself. These macro 
instructions are issued to obtain data from control blocks that are 
otherwise not available te-application programs. INCUIRE macro instruc- 
tions can be issued to obtain information about the status of applica- 
tion programs, devices, and logons. 


4 


An overview of the operation of LUS is shown in MO 13. 
LUS MANAGER 


The LUS manager represents the interface from the end user to LUS. End 
User requests in the form of access method requests (AMRUS) are passed 
to the LUS manager by the LUS router. End user requests processed by 
the LUS manager include OPNDST, OPNSEC, SIMLOGON, REQSESS, TERMSESS, 
CLSSEC, and CLSDST. 


FUNCTION INTERPRETER 


The SSCP-LU secondary half-session represents the interface from the 
SSCP to LUS. Requests are received from the SSCP by the LUS router and 
passed to the function interpreter for processing. The function inter-~ 
preter validates RUs received and passes them on to the appropriate 
finite state machine for processing. The finite state machines will 
pass RUS to the LUS manager for processing, if necessary. RUs processed 
by the function interpreter include INITIATE, CINIT, NSPE, NOTIFY, | 
SESSION STARTED, BIND FAILURE, UNBIND FAILURE, SESSION ENDED, CTERM, and 
TERMINATE requests. 
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The processing of an OPNDST macro instruction is shown in Figure 8-2. 
The two aspects of open-destination ‘Processing are: 


e Establishing a session between two logical units (for es a 
between two application programs) 


e Determining which routines will be used to prepare requests for and 
process requests from the type of logical unit for which the session 
is to be established (through construction of a real DVT) 


In processing an open-destination request, except for application 
Frograms, the open-destination routines must ensure that the desired 
logical unit has not been previously allocated. 


To establish the session, the open-destination routines use the session 
services component to build a session information block (SIB). The SIB 
represents the status of a session request and indicates one of three 
possible states for the request: session request queued, session request 
pending, and session active. If the destination node is available for a 
session, session services indicates in the SIB that the session is 
active. If a SIMLOGON macro instruction is issued and the destination 
node is not available for a session, session services indicates in the 
SIB that the session request is to be queued until the destination node 
becomes available. Then, when the destination node becomes available 
for a session and an OPNDST ACCEPT macro instruction is issued, the SIB 
is converted to the session pending state. Then, the open destination 
routines build a logical unit control block (LUCB), and a function 
Management control block (FMCB) to represent_the session. The FMCB is 
chained to the LUCB, which, in turn, is chained to the ACDEB for the 
application program. After the destination node has accepted the 
session and LU services has issued the Session Started command, the SIB 
is marked session active. 


~The second aspect of open-destination processing is determining which 
routines shall process requests going to and being received from the 
terminal. The application program provides the open-destination rou- 
tine with the identification of the skeleton DVT, which symbolically 
identifies the processes required to support the session. Real DVTs are 
constructed from the skeleton DVTs and are then chained to the FMCB for 
the appropriate half-session. This processing is performed by issuing 
the FMCBADD macro. The FMCB build routines are part of OPEN/CLOSE 
processing. : | | 


If the destination node is an application program, a Bind is sent to the 
application program's SCIP exit routine, after which the secondary end 
issues either a SESSIONC macro instruction to reject the session or an 
OPNSEC macro instruction to establish the session. See "OPNSEC Process- 
ing" below. | 7 


If the destination node is a device-type logical unit, the application 
program must be bound to the logical unit before open-destination 
processing is completed. The open-destination routines send the Bind 
command to the logical unit. If a positive response is received, a 
Start Data Traffic command is sent (if required), and open-destination 

processing is completed. If a negative response is received, processing 
is terminated. | | 


The open-destination routines construct a communication ID for the 
session, add this ID to the CID table, and return the ID to the applica- 
tion program. The application program then uses the communication ID to 
communicate with the terminal. 
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An application program can request that it become the primary end of a 
session by issuing an OPNDST macro instruction or it can request that it 
become the secondary end of a session by issuing an REQSESS macro 
instruction (see “REQSESS Processing" below). A device-type logical 
unit can only make such a request indirectly by issuing an Initiate 
command. When the system services control point (SSCP) receives the 
Initiate, it invokes session services to build an SIB. After the SIB is 
built, the application program can accept logons from other logical 
units. When the application program issues an OPNDST ACCEPT macro 
instruction, the SIB is converted to indicate a pending session. 


REQSESS PROCESSING 


wa ae 


The REQSESS macro instruction is used by an application program to 
indicate that it wishes to be the secondary end of a session. When a 
REQSESS macro instruction is executed, an Initiate RU is sent to SSCP, 
which causes entry into the LOGON exit routine of the application 
program that is to be the primary end of the session. If the primary 
end accepts the session, it responds by issuing an OPNDST macro instruc- 
tion, which results in a Bind command's being sent to the secondary 
end's SCIP exit routine. The SCIP exit routine receives control, and, 
if the secondary end accepts the session, it issues an OPNSEC macro 
instruction to start the session. If the secondary end does not accept 
the session, it issues a SESSIONC (-RSP(BIND)) macro instruction. If — 
the primary end rejects the session, it issues a CLSDST macro instruc- 
tion. | 


OPNSEC PROCESSING 


ep a eee eae i Se ne 


The OPNSEC macro instruction sets up an application program's control 
block structure so that it can be the secondary end of a session. 4 
OPNSEC processing starts after a Bind command is passed to the secondary 
end*'s SCIP exit routine as a result of an OPNDST macro instruction 
issued by the primary end. The SCIP exit routine determines whether the 
secondary end can accept the session. If a session can be established, 
the OPNSEC macro instruction is executed and a positive response to the 
Bind is sent to the primary end. The primary end's OPNDST processor 
sends a Session Started RU to notify the SSCP that a session has been 
established. : | 


CLOSE DESTINATION PROCESSING 


The CLSDST macro instruction terminates sessions between nodes and 
releases the resources for future sessions. The nodes are returned to 
the state they were in prior to OPNDST processing. The session services 
component is used to terminate the sessions between primary and secon- 
dary ends of sessions. The control blocks that defined the session are 
released or reset. Support functions in the host operating system are 
released. The environment is then as it was before open-destination 
processing. A new session can then be established if an outstanding 
session request is present. 


An application program acting as the primary end of a session terminates 
that session by issuing either a CLSDST or a CLOSE macro instruction. 
Any control blocks associated with the secondary end of the session are 
released. The FMCB for the secondary end of the session is dequeued 
from the primary end's LUCB. The secondary end's session control blocks 
are cleaned up to allow it to have future sessions. 
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mhexe are two forms of the CLSDST macro instructions. 


e CLSDST with the RELEASE option releases the allocated node and frees. { \ 
the support modules and control blocks. a 


e CLSDST with the PASS option is used by an SERA CSET OD program to — 
pass. a node to another a aera prograa. 


TERMSESS PROCESSING — 


The TERMSESS macro instruction is used to terminate a session and can be 
issued only by the application program acting as the secondary end of 
the session to be terminated. When the TERMSESS macro instruction is 
executed, a Terminate. RU is sent to the SSCP, which causes entry into ,_ * 
the primary end‘'s LOSTERM exit routine. If it is an unconditional 

TERMSESS request, the SSCP sends an Unbind command to the secondary end. 

If it is a conditional TERMSESS request, the primary end then issues a 

CLSDST macro instruction, which causes an Unbind command to be sent to 

the secondary end, and the break session processor of LUS to be invoked 

to clean up the secondary end's session control blocks to allow it to 

have future sessions. 


INQUIRE pRocessrus 


The INQUIRE macro instruction is issued by the application program to 
obtain specific types of information. Depending upon the type of 
INQUIRE specified, information is retrieved and passed back. to the user. 


Types of information provided are: = 
e User data from a CINIT for a pending session (LOGONMSG) 8 eer 
e Device characteristics for a specific device (DEVCHAR) | ‘ 
e Counts of active sessions and of aeeuee CINITs for this application 
. (COUNTS) 

e Logical unit name and the ‘session ID for the oldest queued CINIT 

(TOPLOGON) | 
@ CID corresponding to syabolic name or symbolic name corresponding to 

the CID (CIDXLATE) | 
e NIB list for the specified resource and all associated resources 

(TERMS) : 
e Application or CDRSC status for a particular resource (APPSTAT) 

@ Session parameters for a particular session (SESSPARN) — 

e Session key and seed for a particular session (SESSKEY) 
The information for a particular request is built directly in an area 
provided by the issuer of the INQUIRE macro instruction. Because of the 
dynamic nature of some of the information that can be requested, the 
caller cannot always know in advance how large a work area is needed to 
contain all the requested information. Therefore, LUS places the ™ 
requested data in the user's area if the user's area is large enough and | 
provides feedback information to the user about the amount of data | : 
supplied. Thus, if the amount of data given to the user is less than or ek 


equal to the size of the work area provided, all the information is 
transferred. However, if the amount of requested information is greater 
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than the size of the area provided, the user can recognize the need to 
reissue the request and provide a work area | large enough to contain all 
the requested data. 


INTRPRET PROCESSING 


The INTRPRET macro instruction is issued by an application program to 
translate an input character string, using the interpret table associ- 
ated with the resource, into an application name. An INTERPRET request 


results in an inspection of the interpret table associated with the 


specific resource, and the interpret table sequence is returned in the 
user-specified area. 


PROCESSING LOST PATH RUS 


Lost Path RUs are sent to LUS by PUS. LUS converts the Lost Path RUs to 
Terminate Other Orderly Cleanup RUs and queues them to the session | 
services PAB. The session services subcomponent of SSCP terminates the 
session and sends a Cleanup or Notify request to LUS. 


PROCESSING CLEANUP RU 


CPD 


Cleanup RUs are sent to LUS by the session services subcomponent of SSCP. 
If the application program has an NSEXIT exit routine, LU services 

frees control blocks .such as.the FMCB, DVT, and EPT, and then sched~ 
ules the NSEXIT exit routine. Otherwise, the application program is 
notified through its LOSTERM exit routine. 


PROCESSING NOTIFY RUS 


Notify RUs are sent to LUS by session services. Each Notify RU is 
handled by building UECB and VRPL control blocks and scheduling: the 
application program's NSEXIT routine. 
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MO 13 (Part 1 of 4). Logical Unit Services (LUS) 


Input Processing Output 
See Note 03a 


Access 
Method ACB Data 
Control Extent Block 


Start or stop queuing Block (ACB) (ACDEB) 
logon requests. 


SETLOGON 
Macro 
Instruction 


Establish a session 

between the application a ae a am 
program that issued 

OPNDST and another 

logical unit. 


OPNDST Macro 
Instruction 


Establish a session 
between the application 
program that issued 
OPNSEC and another 
application program. 


OPNSEC Macro 
Instruction 


Issuer of OPNDST is primary end 
of session. 


Issuer of OPNSEC is secondary 
' end of session. 


a. Logical unit services re- 
ceives control from either 
OPEN/CLOSE PUs or the SSCP. 
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MO 13 (Part 2 of 4). Logical Unit Services (LUS) 


Input 


4q 
aa 
g 


REQSESS 
Macro 
Instruction 


SIMLOGON 
Macro 
Instruction 


Issuer of REQSESS will be sec= 
ondary end of session if ses- 
sion is established. 


Processing Output 


Request the establishment 

* of a session between the 
application program that 
issued REQSESS and 
another application pro- 
gram. 


RDT 
(Primary) 
Create an SIB and, 
" optionally, drive the 
application progam's 
LOGON exit routine or 


complete an outstanding [ 
OPNDST ACCEPT request. 
RDT 
(Secondary) 
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MO 13 (Part 3 of 4). Logical Unit Services (LUS) 


Input 


| Issuer of CLSDST must be primary 
end. 


136 


TERMSESS 


Macro 
Instruction 


CLSDST Macro 
Instruction 


Close 
secondary end 
application 
program 
session 
processing 


Processing - 


Request the termination 

of an application-program- 
to~application-program 
session on behalf of the 
secondary end. 


Terminate session between 
the application program 
that issued CLSDST and 
another logical unit. 


Clean up secondary end 
application program's 
control blocks to allow 
future sessions. ; 
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MO 13 (Part 4 of 4). Logical Unit Services (LUS) 


Input 


Register 1 


RUPEDAF = 
4LU in 
lost 
subarea 


Processing 


Output 


If a Lost Path RU is re- 
ceived, build a Terminate 
Other Orderly Cleanup RU. 


CPCALL SSCP (3) 


If a Cleanup RU is re- 
ceived, release the FMCB, 
DVT, and EPT associated 
with the primary applica- 
tion program. 


RUPEDAF = 
+ Applica- 
tion program 
in session 
with LU in 
lost subarea 


FMCBDEL 
OPEN/CLOSE (6) 
Register 15 


Return 
Code 


RUPE 
RUPESNS = 
Sense Code 


If a Notify RU is received, 
build the UECB and VRPL, 


and schedule the applica- 
tion program's NSEXIT exit 
routine. 


[22] Return. 


- I | 


an NSEXIT routine, LUS releases 
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with the session before calling 
the NSEXIT exit routine. If the 
NSEXIT routine is not coded, the 
application program is notified 
through its LOSTERM exit routine. 
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The Multisystem Networking Facility (MSNF) is the ACF/VTAM feature that 
makes it possible to have a data communication network with more than 
one host system and more than one domain. With this feature, Logical 
Units (LUs) can communicate between domains. LUs are application 
programs or logical unit devices (including BSC 3270 terminals defined 
as PU=YES). Local 3705 Communications Controllers are used to connect 
domains. The cross-domain resource manager(CDRM) is the major component 


of ACF/VTAM for the Multisystem Networking Facility. Other functions 


for the Multisystem Networking Facility are provided by modules that are 
extensions of the system definition (SYSDEF), system services control 
point (SSCP), and network inquiry components of ACF/VTAM. 


An overview of the operation of these components and their detailed 
descriptions can be found in the publication ACF/VTAM Logic: Multisystenm 
Networking Facility. 
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The ACF/VTAM Encrypt/Decrypt Feature improves data security for comnuni- 
cations between logical units that are capable of cryptography. The 
Encrypt/Decrypt Feature is available in ACF/VTAM for OS/VS1 and OS/VS2 
MVS. It requires that the IBM Programmed Cryptographic Facility be 
active in the host processor and that cryptographic keys be defined in 
the cryptographic key data set (CKDS) as described in IBM Programmed 
Cryptographic Facility Installation Reference Manual. 


The Encrypt/Decrypt Feature supports single-domain cryptographic 
sessions and, in conjunction with the ACF/VTAM Multisystem Networking 
Facility, it supports cross-domain cryptographic sessions. 


The Encrypt/Decrypt Feature consists of extensions to the initializa- 
tion, system definition, SSCP, network inquiry, OPEN/CLOSE, TSC, and 
CDRM components of ACF/VTAM. Systems without the Encrypt/Decrypt 
Feature contain base modules in place of the Encrypt/Decrypt Feature 
modules. The base modules reject requests for cryptographic services 
and issue error messages stating that this feature is not supported in 
this host system. Descriptions of the base modules are included in the 
publications ACF/VTAM Logic and ACF/VTAM Multisystem Networking Facility 
Logic. When the Encrypt/Decrypt “Feature is installed, the base modules 
are replaced by the feature modules, which are described in ACF/VTAM 


Encrypt/Decrypt Feature bogis. 
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The Teleprocessing Online Test Executive Program (TOLTEP) schedules, 
controls, and supports the online test programs (OLTs). The OLTs 
exercise and evaluate the hardware capabilities of the various IBM 
devices supported by ACF/VTAM. TOLTEP is attached by ACF/VTAM when 
ACF/VTAM is started and resides in the ACF/VTAM partition or address 
space. 


More than one user can use TOLTEP concurrently under one ACF/VTAM task. 
TOLTEP runs concurrently with other tasks in the systea. 


Refer to ACF/VTAM Diaqnostic Techniques for information on how to run 
TOLTEP and the devices that TOLTEP supports. 


3 


| 


STEM RELATIONSHIP 


ES SED ED ED ET ES 


Figure 18-1 shows the relationship of TOLTEP to ACF/VTAM,the operating 
systera that selected ACF/VTAM,. the OLTs, the control terminal, and the 
terminals being tested. a ; 


DOS/VSE or OS/VS Operating System | * 


Control 
Terminal 


Alternate 

Printer 
| 

Test | 

Terminal | 


10s 


TOLTEP 


SNA 


| Test 
Terminal | 
i 


Non-SNA ee | 


Online 
Tests (OLTs) 


APi — Application Program Interface 


10S — Input/Output System 
NCS — Network Contiguration Services 


Figure 18-1. TOLTEP/System Relationship 


Licensed Material—Property of IBM 
Chapter 18. Teleprocessing Online Test Executive Program 143 


- SENET ge oe eo cnt = tn 


ee ae eR OAPI SPY eA SIN ASPEN CREF Renn CR RSE rt ELITE EE NCE A NE A NYS I CO ERS a MRR HST CEE TP PL A AE EEE ION I PIE IEE TENT TR TE PERETTI S| A, AE TT TEN ETE EINEM RELIES 2 ARORA TAI ETT ATR RAED STIS | 
= re is ‘ pene ates S : 


TOLTEP/API 


TOLTEP communicates with the control terminal, the alternate printer, wae, 


and SNA test terminals by using the application program interface (APT) 
in the same manner as other application programs. TOLTEP issues API 
macro instructions such as OPEN, OPNDST, INQUIRE, SEND, RECEIVE, CLSDST, 
and CLOSE ©. ‘ 


TOLTEP/OLTS 


In 


The OLT test section communicates with TOLTEP by using the TOLTEP macro 
processing routines (described in ACF/VWTAM Logic: Base System). The OLT 


calls TOLTEP routines such as EXIO (to execute I/O) and DPRINT (to print | ee ae 


diagnostic messages). This operation is the same as other online test | 
executive programs. 


ZEST PARAMETERS 


The test run definition (a response to ENTER-DEV/TEST/OPT/) is the 
primary input to TOLTEP. The TOLTEP user selects the devices to test, 
the tests to execute, and the options affecting the way TOLTEP handles 
the testing process. The TOLTEP user enters the test run definition 
from the TOLTEP control terminal. TOLTEP also paca ee Fae following 
verbs for other, non-testing operations. | 


e CT=term allows the user to ) specify another termi nal as the TOLTEP 
control terminal. 


e DUMP allows the user to dump a specified portion of TOLTEP ‘virtual 


storage. oes 


e PROMPT allows the user to request examples of correct EePhies to the 
ENTER-DEV/TEST/OPT message. | 


e CANCEL allows the user to terminate a TOLTEP testing session from 
the control terminal. 


e TALK allows the OLT to communicate with the control terminal opera- 
tor. | 


e UPDATE allows the user to exhibit, add, change, copy, Or delete a 
Poneeaanersoe daia set (for OS/VS only). 


MESSAGES 


TOLTEP issues messages during the testing that inform the TOLTEP user of 
the status of the testing. These messages and appropriate replies, if 
any, are described in ACF/VTAM TOLTEP. TOLTEP does not require the 
reply character and the message ID but they are required by OS/VS if the 
system console is being used as the TOLTEP control terminal. They are 
not required by TOLTEP in DOS/VSE or OS/VS when the TOLTEP control 
terminal is other than the system console. 


The OS/VS message prefix of ITA is used for TOLTEP messages. The 
DOS/VSE message prefix is F. The message ID and text are the same for ie 
all systems. | 3 | ) 
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TOLTEP DATA AREAS 


The formats of the resident common area and the test work area are 
provided in the ACF/VTAM Data Areas. 


RESIDENT COMMON AREA (RCA) 


The resident common area is initialized when TOLTEP is attached by 
ACF/VTAM. This area serves as an anchor block for all TOLTEP modules 
and contains: | 

e The TOLTEP ACB (access method control block) 

e Pointers to the chain of test work areas (TWAS) 


® Pointers to several TOLTEP routines 


® Control information 


e The TOLTEP RPL (request parameter list) 


e A work area 
TEST WORK AREA (TWA) 


For each user that starts TOQOLTEP, the test initialization routine = 
creates a test work area for that particular user. The test work area 
is associated with the user and contains several subtables and fields 
that allow the user to control testing. The subtables in the test work 
area are: | | | | | 4 


- Section Control Table (SCT) 


The section control table contains: 


e Flags associated with the test section and the OPT response to the 
ENTER-DEV/TEST/OPT message. 


e A copy of the first 20 bytes of the CDS for the primary device (the 
device currently being tested as specified in the DEV response to 
the ENTER-DEV/TEST/OPT message). 


The connection description area contains: 
e Chain pointers to other test work areas 
® Pointers to. areas within the OLT area 


e TOLTEP processing condition flags 
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The device entry table is filled in by the device decode routine. There | — 
are 18 entries in the table: the first is for the control terminal, the 
second is for the alternate printer, and the remaining 16 (the maximun 
number of devices that may be specified) are for the devices specified 
in the DEV EQS poo8s to the ENTER-DEV/TEST/OPT . message. Each entry 
contains: : 
e Device information 
e Flags indicating. TOLTEP's use of the daveee : 
Section List Table (SLT) | : | > : 
The section list table is filled in by the test decode routine. This 
_ table contains: | 
e The "family name" of the test section ae example, T3700) 
e Flags indicating testing status 
e The IDs and flags associated with each test section specified 
(repeated 26 times) 
e Pointers anal values used in selecting the test sections 
e 7 - os ~ yee a = . - 
General Work Area (GHA) | a a | | 7 | os 
The last subtable in the test work area is the general work area, which | ro | 


contains: 


e Save areas for individual TOLTEP routines ehae have calls to other . 
routines in response to an OLT request 


e Buffers for messages from TOLTEP 
e Work areas 


@ Request Parameter Lists (RPLs) for. the control terminal and alternate 
printer. 


e Various other fields sea Ge TOLTEP routines during testing 
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ABBREVIATIONS 


ACF 


ACF/VTAM 


ACTLU 
ACTPU 
API 
APPL 
APT 
ASCB 
ASXB 
ATCVT 
AVT 


BFT 
BHSET 


CA 
ccw 
CDRM 
CDRSC 
CID 
CIDCTL 
CLSDST 
CONFIG 
CONFT 
CRA 
CRR 
CSM 
CSMI 
CSW 
CVT 
C/D 


DACTLU 
DACTPU 
DAF 
DET 
DEV 
DLRPL 
DVT 


ECB 
ERP 


FIDO 
FID1 
FID2 
FIFO 
FACB 


ID 
ICNCB 
IRB 
I/o 


LDNCB 
LIFO 
LQAB 
LU 
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rai Fg ne Ee ee pa ts Re é a Oe a Fis as lea ciate Le | a ‘i “ eat cas ia Seer 


Abnormal end of task 

Access method control block 
ACF/VYTAM data extent block 

Advanced Communications Function 
Advanced Communications Function for VTAM 
Activate Logical Unit 

Activate Physical Unit 

Application program interface 
Application (progran) 

Asynchronous processing table 
Address space control block 

Address space extension block 
ACF/VTAM communication vector table 
Address vector table 


Boundary function table 
Block handler routines 


Channel adapter 

Channel command word 
Cross-domain resource manager 
Cross-domain resource 
Coagunications identifier 


CID control a 


Close destination 7 
Configuration | % 
ACF/VTAM configuration table 
Component recovéry area 
Component recovery record 
Communication system manager 
Communication system manager interface 4 
Channel status word 

Communications vector table 

Connection Description (TOLTEP) 


Deactivate Logical Unit 
Deactivate Physical Unit 
Destination address field 

Device entry table 

Device | 

Dump/load/restart parameter list 
Destination vector table 


Event control block 
Error recovery procedure 


Format identifier 0 (PIU) 

Format identifier 1 (PIU) 

Format identifier 2 (PIU) 
First-in first-out 

Function management control block 


Identification 

Intelligent controller node control block 
Interruption request block 

Input/output 


Local device node control block 
Last-in first-out 
Lock queue anchor block 
Logical unit 
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LUS Logical unit services 


TSPL Transmission subsystem parameter list 
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LUCB Logical unit control block 
MNT Majjor node table 
NAB Network address block 
NCB Node control block 
NCSPL Network configuration services parameter list 
NIB Node identification block 
OLT Online test 
OPNDST Open destination 
OPT Option 
PAB Process anchor block 
PIU Path information unit 
PLM Program logic manual 
PSS Process scheduling services 
PST Process scheduling table 

PU Physical unit 
PUS Physical unit services 
QAB Queue anchor block 
RAS Reliability, availability, and serviceability 
RCA Resident common area 

RDT Resource definition table 
RDTE Resource definition table entry 
RH Request/response header 
RPH Request processing header pe 
RPL. Request parameter list , _ a | 
RU Request/response unit es ke 
RUPE Request/response unit processing element . 
SAF Source address field oe 7 4 
scr Section control table 
SDT Start Data Traffic 
SDVT. Skeleton destination vector table 
SIB Session information block 
SIo Start I/0 
SLT Section list table 
SMS Storage management services 
SNA Systems Network Architecture. 
SNT Specific (minor) node table 
SRB Service request block (0S/VS2 only) 
SRT Symbol resolution table 
SRTD Symbol resolution table directory 
SRTE Symbol resolution table entry 
SSCP System services control point 
STSN Set and Test Sequence Numbers 
SYSDEF System definition 
TIE TOLTEP interface element 
TRAC Trace record 
TRCPL Trace parameter list 
TWA Test work area 
TOLTEP Teleprocessing Online Test Executive Program 
TSC Transmission subsystem component 
TSCB Transmission subsystem control block 
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UECB 


VTAM 


WRE 


XID 


User exit control block 
Virtual Telecommunications Access Method 
Waiting request element 


Exchange identification 
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Glossary 


This glossary defines terms and abbreviations that are 
important in this book. It does not include terms 
previously established for IBM operating systems and 
IBM products used with ACF/VTAM.. Additional 
terms can be found by referring to the index, to | 
prerequisite and corequisite. books, and to. the IBM 
Data Processing Glossary,. GC20-1699. ee 


This glossary includes definitions developed. by: the 


American National Standards Institute.(ANSI).and the 


International Organization for Standardization. dso). 
This material is reproduced from the American: 
National’ Dictionary: for Information Processing, 
copyright 1977 by the Computer and Business. _. 
Equipment Manufacturers Association, copies:of. - 
which may be purchased from the American. National : 
Standards Institute, 1430: rene ney New. York, New | 


‘York 10018. 


A. complete commentary taken from:ANSLis: identified : 


by an asterisk that appears between the:term andthe. - 
beginning of the commentary; a definition taken from: 


for that definition. 


ANSI is identified. by: an asterisk after.the:item number - 


The symbol ISO: at. ‘the Beginning of a. . definition . 


indicates that it has been discussed and agreed upon ; at 


meetings of the International Organization for 


- Standardization Technical Committee. . 


97 /Subcommittee. 1: (Data. Processing), and. has. also. 
been. approved by: ANSI . 


The symbol SCI ‘at the heghiding of a definition. 


_ indicates that it is reprinted from:an- early working . 


document of ISO Téchnical:Committee'. : 
97/Subcommittee I and that final agreement has not. 
yet been reached among its Participating members. ' 


A 
ACB. Access method control block. 
ACB name. (1) The name of an ACB macro ‘netrneion: (2) A | 
name that can be specified in the ACBNAME parameter of an 
APPL statement. This-name:allows an ACF/VTAM 


application program. that is used in more than one domain to 
specify the same application program identification. (pointed to 


_ by the APPLID parameter of the program’s ACB statement) in 
each copy. ACF/VTAM knows the program by both its ACB. 

name and its network name (the name of the APPL statement). | 

_ Program users within the domain can request logon using the“ 
“ACB name or the network name; program users in other 


domains must use the network’ name (which must be unique in 


the network). Contrast. with network name. 


accept. In ACE/VTAM, to establish a session between a logical 


unit and a primary application program as the result of a logon. © 


The logon may be originated by the logical unit, the terminal 
operator, the network operator, another primary application 
program, or ACF/VTAM. Contrast with acquire (1). 


sti ain OR ST OP ade se nace ata ee e E Loe Tah ge a e cag eet e 


access method control block (ACB). A control block that links an 
application program to VSAM or ACF/VTAM. . 


accounting exit routine. In ACF/VTAM, an optional, 


user-written routine that collects statistics about sessions in the 


‘communication network. 


ACF. Advanced Communications Function.. 


ACF/NCP.: Advanced Communications Function forthe — 


-. Network Control Program. 


ACF/TCAM. -Advanced Communications Function for the 


Telecommunications Access Method. 


ACF/VTAM. Advanced Communications Function for the 
vate Telecommunications Access Method. .— 


ACF/VTAM. application program. A program that has opened an — 
ACB to identify itself to ACF/VTAM and can now issue. 
ACF/VTAM macro instructions. 


ACF/VTAM definition, The process of defining the 


communication network to ACF/VTAM (which is called 


“network definition ”) and modifying IBM-defined 
characteristics t to: suit the needs of the user. 


- 


ACF/VTAM definition library. The DOS/VSE files or OS/VS 
data:sets that contain the definition statements and start 


options filed during ACF/VTAM definition. 4 


- acquire. (1) In relation to an ACF/VTAM application program, 
to establish a session between a logical unit and an application. 
_ program i in the absence of a’ logon. The session is-established at 
the primary application program’s initiative. Contrast with _ , 
: accept. (2) In relation to ACF/VTAM resource control, to take’ 


over resources: (communications controllers or physical units) 
that were. formerly controlled by a data communication access 


method i in another domain, or to assume control of resources 


that: were controlled by this domain but released. Contrast with 
release. See also resource takeover. 


active. Pertaining to'a major node that has been made known to 
ACF/VTAM or pertaining to a minor node that is in session or 


available fora session. Contrast with inactive. 


| adjacent domain. A domain that is physically connected to 


another domain by a single cross-domain link or by a shared 
local communications controller. 


adjacent node. A node that is physically connected to another 
node by a single data link. 

Advanced Communications Function. (ACF). A group of program 
products for users of DOS/VSE and OS/VS that can provide 


. improved single-domain and, optionally, multiple-domain data 


communication capability. 
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Advanced Communication Functions for the Network Control 
Program (ACF/NCP). A program product that provides — 
communications controller support for single-domain and 
multiple-domain data communication. 


Advanced acai ats useeiss for the Telecommunications 


Access Method (ACF/TCAM).. A program product that provides" 
single-domain data communication capability, and, optionally, _ | 


multiple-domain capability... 


Advanced Communications Function fob the Virtual a 
Telecommunications Access Method (ACF/VTAM).. , program: 
product that provides single-domain data. communication : 
capability and;. optionally,. muitiple-domain capability. 


any-mode. Tn ACF/VTAM: Q) The form. of a receive é request. 


that obtains data from one. unspecified: terminal. (2) The form: : | 


of request that. establishes a session. with an unspecified logical 
unit that has logged: on. @ Contrast with: specific-mode. See. 
also continue-an ‘4 mode... oe 


application stayez In SNA, the functional layerot sue cis indies: 
session in which the:end user's: application ‘program: is executed. a 


See also function management, | Sransmiseton subsystem. 


. application program. identification. ‘The juitbolic name s by- which. eS 


-an application program is identified to ACF/VTAM.. Itis:. 
| ‘specified i in the APPLID: parameter of. the ‘ACB macro. 


: instruction: Te corresponds to: the: ACBNAME. parameter i in. = the: : | 
fE is is defaulted, to oes name a 


APPL statement. or, if ‘the 2 ACBNAD AME 
of the APPL statement. — ae er Se, 


application progrant. major node. In ACF/VTAM, a imember 


(OS/VS)-or book (DOS/VSE) of the: ACF/VTAM definition | - 


library that: contains: one or. more -AEPL statements, each: 
representing an. a application Program; Fete Ge a 


7 APP uD routine. ‘Synonyet for lagoninterpret routine: 
| asynchronous operation, Ta -ACE/ f r TAM; : 
_ request for session establishment or: data transfer in which: the 
application: prograin., is: allowed to continue execution: while . 
ACF/VTAM: performs. thei ‘operation. ‘ACE/VTAM: interrupts 
the ‘Program: as soon as. the e operation: is eommaleeed: me 


ae 
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asynchronous. operation. ou 
authorization exit routine: In ACE/VTAM; ‘an. optional, 


user-written routine that: approves or. disapproves requests for’ 
session establishment or session, termination. . aes 


authorized: path. In ‘ACE/VTAM. for. os/ VSz MVS: @ facitity: 


that enables an authorized: ‘application program ta: specify that we 


data transfer or related. operation be carried out: ny a faster. 
manner than usual. ~~". 


automatic logon.- AY process aby: which ACF/VTAM: creates: a 
logon fora logical unit to a designated. application: program... 


_ whenever the logical unit is not in session with or queued’ for: a. e 
session with'another program.. Specifications for the automatic: : 


— logon can’ be made-when:the logical unit is: defined:or‘can be ” 
made by the network. operator i in the Beis . ae ae LOGON 
r commpandasSett alsa cdnifolling application: 


‘boundary function. In SNA: ay A puietal term used for any one 
of several capabilities:of a communications controller node: (a) ( 
transforming the network address form to a local address al Pig RE 
and vice.versa, for attached terminals or cluster control unit © 4 
“nodes; (b) performing. physical. unit services.and sequence - 

:. mumbering for. attached, low-function: terminals within its 

_Subarea;’2 and (c) providing pacing of the data flows for 


onl cack: as. a 7 | 


: cancel closedown.. ‘A closedown in'which ACF/VTAM is. 


available. In ACF/VTAM: (1) Pertaining to a logical unit that 
supports only one session, is active, and is not in session with or 
queued for a session with an application program. (2) - | f™ 
Pertaining to an exit routine that has been specified by an Ma: 4) 
application program and that is not being executed. - as 


basic information unit (BIU). In SNA, the unit of data and 
control information that is passed between connection point — 
managers. It consists.of a request/response header (RH) _ 


~ followed by a. request/ response unit (RU). 


. basic mode.. In ACE/VTAM Release 1 and in VTAM, a mode of. 

_ data transfer in which the. application program can 

' communicate with non-SNA terminals. Contrast with record * 
mode, -— 


basic transmission unit (BTU). (1) In the network control 


program, the unit.of exchange between the host processor and: 


-. the communications controller. ‘It consists of control 

information and may also include data. The control 

information consists ofa: basic transmission header (BTH) and 
' - ‘abasic device unit (BDU). .Alfdata transferred between the . 

W. » processing unit. and the communications controller is:preceded 
“by a BTU. (2) In.SNA; the unit of data and control information 
: ‘passed. between path: control components. The BTU' can consist : 

_ of one or more: path: infortiation: units. (PIUs), depending on | 
whether Doras: is done. by the: path control that builds the 

: BTU.: 


component and. functional structure that performs the above: ; 
‘capabilities. 


-bowidary node: In. SNA,-a‘network node'that performs — 
E baat functions: ‘See also: boundary function: . 


_ bracket." In ACF/VTFAM; an atinterruptible unit of werk 
consisting ‘of one or more chains of. request units, and their . 


- data base gee responses, ‘updiite transactions, remote rine : 
‘entry. output sequences. to.work stations; and similar 
Spphications. . eA os a 


bracket protocol:: ‘In-SNA, a-data flow control protocol in which . 
exchanges between logical units (LUs) are achieved through the: 
“use of brackets, with one LU designated at session initiation as - 
“the first speaker, and the other.LU as the bidder. The bracket. 

: protocol involves bracket initiation and termination rules. 


| o Ci. 


winnted asthe: result of:an operator: command... 


Licensed Material—Property of IBM | 


152 


See PREP G ET eT EE oe ee EES ALLS TET I TT I TY OT TIT LIT TO LG IIE LITLE NEL ELT MT IE I I 
i Bay Peat tae igen anger: Ge oe PERRI peters = wants ee ee oe ee nr Oe Saar 


CDRM. Cross-domain resource manager. 
CDRSC. Cross-domain resource. 


change-direction protocol. In ACF/VTAM, a method of 
communication in which the sender stops sending on its own 
initiative, signals this fact to the receiver, and prepares to 
receive. 


character-coded. In ACF/VTAM, pertaining to a logon or 
logoff command usually entered by a terminal operator from a 
keyboard and sent by a logical unit in character form. The 
character-coded command must be in the syntax defined in the 
installation’s unformatted system services definition table. 
Contrast with field-formatted. 


checkpoint. A point at which the information about the status of 


a data communication system is recorded. The system can then 
be reconstructed to its-status at or near the time of failure. 


‘CID. Communication identifier. 


ciphertext. In ACF/VTAM, sannye for ite i data. 


clear data. Data that is not sais Synonymous with 


. plaintext. 


clear soil: | A session in which only clear data’ istransmitted _ 
or received. Contrast with cryptographic session. — 


closedown. The deactivation of a device, program, or system. 
See also cancel closedown, orderly closedown, and quick 
closedown. | 


cluster control unit. A device that can control the input/output 
operations of more than one device. A remote cluster control 
unit is attached to a host processor only through a 
communications controller. A local cluster control unit is 
attached through a channel. A cluster:control unit may be. 
controlled by a program stored.and executed in the unit; for 
example, the IBM 3601 Finance Communication Controller. — 
Or it may be controlled entirely by hardware; for example, the 
IBM 2972 Station Control Unit. See also communications 
controller and SDLC cluster controller: 


cluster controller. See cluster control unit and SDLC cluster 


controller. : 
command. (1) A request from a terminal for the performance of 
an operation or the execution of a particular program. (2) In 
SNA, a request unit initiating an action or beginning a protocol; 
it is used in contrast with reply, which is a request unit (not a 
response) that is sent in reaction to a command. For. example: 
Quiesce (a data flow control request), is.a command, while 
Quiesce Complete is the reply. (3) In SNA, a data flow control 
or session control request that may be sent or received by an 
application program. 


common network. In SNA, the network consisting of path 
control and data link control elements that routes and moves 
path information units between any two transmission control 
elements. 


communication control character. *(ISO) Synonym for 
transmission control character. 


communication control unit. A communication device that 
controls the transmission of data over lines in a 
telecommunication network. Communication control units 
include transmission control units and communications 
controllers. 


communication controller. A type of communication control unit 
whose operations are controlled by one or more programs 
stored and executed in the unit. Examples are the IBM 3704 
and 3705 Communications Controllers. 


communication identifier (CID). In ACF/VTAM, a key for 
locating the control blocks that.represent an active session. The 
key is created during the session-establishment procedure and 
deleted when the session ends. 


communication line. Any physical link, such as a wire or a 
telephone circuit, that connects one or more remote terminals 
to a communication control unit, or connects one 
communication control unit with another. Contrast with data 
link. 


configuration restart. In ACF/VTAM, the facility for immediate 
recovery after a failure in the NCP or communication controller 
or after a loss of contact with a physical unit or logical unit, or 
for delayed recovery after a failure or deactivation of a major 
node, ACF/VTAM, or the host processor. Recovery may 


include reloading the NCP or restoring the network by means of 


a checkpoint. Restarting by means of checkpoint data requires 
the user to specify one or more VSAM data sets in which 
ACF/VTAM keeps a record of changes to initial configuration 
data. 


connection. See physical connection. 
connection point manager (CP manager). In SNA, one of the three 


components of transmission control; it provides a common 
mechanism by which session control, network control, and 


' network addressable units communicate with their 


corresponding elements through the common network. The 
unit of information handled by the connection point manager is 
a request/response unit (RU). The unit of control information 
built by the sending connection point manager and interpreted 
by the receiving connection point manager isa 
request/response header (RH). See also session control, 
network control. | 


 continue-any mode. In ACF/VTAM, a state into which a logical : 


unit is placed that allows its input to satisfy an input request 
issued in any-mode. While this state exists, input from the 
logical unit can also satisfy input requests issued in 
specific-mode. Contrast with continue-specific mode. 


continue-specific mode. In ACF/VTAM, a state into which a 
logical unit is placed that allows its input to sately only input 
requests issued i in specific-mode. 


controlling application program. An application program to which 
a logical unit (other than a secondary application program) is 
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automatically logged on whenever the terminal is active and 
available. See also automatic logon. 


converted command. An intermediate form of a character-coded 
logon or logoff command produced by ACF/VTAM through 
use of an unformatted system services definition table. The 
format of a converted logon or logoff command is fixed; the 
unformatted system services definition table must be 
constructed in such a manner that the character-coded — 
command (as entered by a logical unit) is converted into the - 
predefined, converted command format.. See also 
character-coded. 


cross keys. In ACF/VTAM, see : crear domet keys. - 


cross-domain. Pertaining to control or resources involving more 


than one domain... 


cross-domain keys. A pair of cryptographic keys used at a host 
processor to encipher: the: ‘cryptographic. session key that is sent — 
to another. host: processor and to decipher the cryptographic 
session key that is sent from another host:processor during © 
cross-domain cryptographic session establishment. 


cross-domain link: A data communication inline physically 
connecting, two: domains. See. also local-to-local link. 


cross-domain: resource: (CDRS). A resource owned ie another. - 


domain but known i in this: domain. ‘by. name and associated te 


cross-domain: resource: manager. 


cross-domain fesource manager (CDRM): The sneae of the 


system services control point (SSCP) that controls cross-domain 


sessions, 


cross-domain session. “A session between network addressable 
units i in different domains 


CRY. Cryptographic verification, 


cxyptographic: Pertaining to the transformation of data to. 
conceal its or . La . , | 


cpieaivite algorithm. A set: “of ales that ae the. 
| mathematical sao al required to encipher. and sacs al data... 


cryptographic bey A 64-bit vide (aaa 56 saan 
bits and 8 parity bits) that functions with the DES algorithm i in 
determining the output of the DES algorithm. See also. 
cross-domain keys, cryptographic session key, host master no 
and ey gosical unit. key. 


cryptographic session.. A session in which datamaybe —— 
enciphered before it is transmitted and deciphered after it is 
received.. See also required cryptographic session and selective 
cryptographic session. Contrast with clear session. 


cryptographic sciize key. In ACE/VTAM, a data sieeve : 
key used to encipher and decipher data transmitted ina — 
cryptographic session. 


cryptographic verification (CRV) request.: A request unit used to 


return an initial chaining value.to'the secondary logical unit to: _ 


verify that the secondary logical unit is using the same 
cryptographic session key. 


Dp 
data communication. *The transmission and reception of data. 
data encrypting key. A cryptographic key used to encipher and 
decipher data transmitted in a cryptographic session. See also 


cryptogrpahic session: key. Contrast with key encrypting key. 


Data Encryption Standard (DES) algorithm. A cryptographic 


_ algorithm designed to encipher and decipher 8-byte blocks of =~ 


data using a 64-bit cryptographic key, as specified in the | 
Federal Information Processing Standard Publication 46, 
January 15,1977. 


data flow. In SNA, any of several flows in a given session, 
characterized as either primary-to-secondary or 
secondary-to-primary, each of which may be normal or 


_ expedited... 


_ data flow control. In SNA, a set of protocols and control 


functions within function management used to assist in 


-» controlling the flow of requests and responses within a session. 
Contrast with function management data (FMD) services. 


data flow control protocol. .In SNA, the sequencing rulesfor _ 


‘requests and responses by which network addressable units in a 
communication network coordinate and control data transfer 
and other operations. For example, see bracket protocol. 


data link. (1) (SC1) An assembly of those pants of two data _ 
terminal equipments that are controlled by a link protocol, 
together with their interconnecting data circuit, that enables 


- data to be transferred from a data source to. a data sink. (2) . 


The communication channel, modem, and communication | 


-” controls of all stations connected to the communication 


channel, used in the transmission of information between two 


‘or more stations. (3) The physical connection andthe  =—_..; 


connection protocols between the host and communication 
controller nodes via the host data channel. (4) Contrast with. 
communication line. 


Note:..4 communication line is the physical medium; for 
example, a telephone wire, a microwave beam. A data link 
includes the physical medium of transmission, the protocol, and 


_ associated communication devices and programs~it is both 


logical and physical. 


data link control (DLC). In SNA, one of the constituent parts of 


the transmission subsystem, and one of two constituent parts of 
the common network. It initiates, controls, checks, and 


terminates the data transfer over a data link between two 


nodes. Two distinct DLCs.are defined in SNA: the DLC for 
the System/370 data channel, and SDLC for serial-by-bit data 
links. See also path control and transmission control. 


data link control protocol. A set of rules used by two nodes on a 
data link to accomplish an orderly exchange of information. 
Synonymous with line discipline. 
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data transfer. In data communication, the sending of data from 
one point in a communication network and the receiving of the 
data at another point in the network. 


data transmission. The sending of data from one point in a 
communication network for reception elsewhere. 


decipher. To convert enciphered data into clear data. one 
with encipher. 


definite response. In SNA, a form of response requested in the 
request header for a request.unit; the receiver is requested: to 
return a response whether positive or negative. contrast with 
exception response and no response. 


definition statement. In ACE/VTAM, the means of describing 
an element of the communication network. 


DES. Data Encryption Standard.. 


device control character. (ISO) A control character used for the 
control of ancillary devices associated with a data processing 
system or data communication system, for example, for 
eyacning aati devices on or off. 


, dsiecene logical unit. A logical unit that represents ace . 


other than an ACF/VTAM application program (such as 2 
logical unit for a 3270 terminal or a eee unit for a 3790. 
application program). 

disconnection. The termination of a cieeical connection.. 
DLC.. Data link control. 

domain. In a data communication system, the portion of the - 
total network that is controlled by the SSCP in one data: ~ 


communication access method. 


domain operator. In a multiple-domain network, the person.or 


program that controls the operation of the resources:controlled . 


by one access method. Contrast with network operator (3). 


dormant state. In ACF/VTAM, when processing a VARY 
NET,INACT,I command, the stage at which alf I/O for the 
node has been completed. At this stage, the node’s session has. 
ended, the node may be physically disconnected as well. 


DRDS. Dynamic reconfiguration data set. 


duplex. *(1) (ISO) In data communication, pertainingtoa 
simultaneous two-way independent transmission in both: 
directions. Synonomous with ad alee (2) Contrast with 
half duplex. d, 


‘dynamic reconfiguration. In ACF/ VTAM, the process of. . 
changing the network configuration (SNA clusters and _ 
terminals) associated with an NCP boundary node, without: 
regenerating the NCP’s configuration tables. 


dynamic seciahawiuiisa dete wat «(DRDS). In ACE/VTAM, a data . 


set used for storing definition data that can be applied to.a 
generated NCP configuration at the operator's request.. 


emulation mode. The function of a network control program — 
that enables it to perform activities equivalent to those 
performed by a transmission control unit. Contrast with 
network control mode. 


encipher. (1) To scramble data or convert it, prior to 
transmission, to a secret code that masks the meaning of the 
data to any unauthorized recipient. (2) In ACF/VTAM, to 
convert clear data into enciphered data. Contrast withdecipher. 


enciphered data. Data that is intended to be illegible to all 


_except those who legitimately possess the means to reproduce 


the clear data. Synonymous with ciphertext. 


end user. The ultimate source or destination of information 
flowing through a system. An end user may be an application. 
program, an operator (such as a terminal user ora network 
operator/administrator), or a data medium (such as cards or 


tapes). 


exception message. See exception request. — 


exception request. In communicating with a logical unit, a 
request unit that indicates an unusual condition such as a 
sequence number being skipped. When ACF/VTAM detects. 
such a condition, it notifies the application program. 
ACF/VTAM or the application program. provides sense 
information which is included in the response that is sent! to the 
logical unit. | 


exception response. (1) In SNA, a response requested in the RH 


for a request unit; the receiver is requested to return a go 
only if it is negative. Contrast with definite response. (2) 


Synonym for negative response. 
exit list (EXLST).. A control block that contains the addresses of 


execution; for example, routines that handle logon processing 
or I/ 0 errors. 


exit routine.. Any of several types of special-purpose | 


- routines that receive control when specified events occur during | 


user-written routines. See accounting exit routine, authorization 


exit routine, EXLST exit routine, logon-interpret routine, and 
RPL exit routine. 


EXLST exit.routine. A type of user-written routine whose 
address has been placed in an exit list (EXLST) control block. 
See also RPL exit routine. - 


expedited flow. In SNA, a data flow designation indicated in the 


transmission header (TH). It is independent of and controls the 
normal flow. Both the primary-to-secondary and 
secondary-to-primary flows are split into normal and expedited 
flows. Requests.and responses on a given (normal or expedited) 


- flow are processed sequentially within the path, but the 
' expedited flow traffic may be moved ahead of the normal flow 


traffic within the path. Contrast with normal flow. 


external domain. A domain controlled by a different system 
services control point (SSCP). 
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F host processor. In a data communication system, the processing 
| . unit in which the data communication access method resides. 
FD. Full duplex. See duplex. _ | : fi } 


\ _f 
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FDX. Full duplex. See duplex. 
FID. Format identification (field). 


field-formatted. Pertaining to a logon or logoff command that is 
‘encoded into fields, each having a specified format such as 
binary codes, bit-significant flags, and. symbolic. names. 
Contrast with character-coded. _ 


format identification (FID) field. In SNA, a field in-a 
transmission header (TH). that defines the subsequent format of 
the header and the type of TH fields involved with a- 
transmission. 


‘formatted system Services (FSS). A portion. of ACF/VTAM that 
provides certain system services as a result of receiving a 
field-formatted command, such as an Initiate or Terminate. 
command. Contrast with unformatted system services (USS). 
See also. field-formatted. | 


full duplex (FD, FDX). Synonym for duplex. 


function management (MD. (1) In SNA, the layer of ‘functional 
capability between the application layer and the transmission _ 
subsystem. It includes data flow.controfand function. —__ 
management data (FMD) services... See also application Hayes 
transmission subsystem. (2):In ACF/VTAM, the insertion of . 
control information. within request units so that the request _ 
units sent to.a particular type of terminal are in the aaa 
_ format and so that request units received from that type of. 
terminal ; are. oe properly... 


4 


function management: data (FMD) services. In SNA, the 
component of function management responsible for 
request/: response units. marked. as © “function management data: 
This includes presentation services and: logical unit services 
(within the logical unit); physical unit services (within the 
physical unit); and network.services (within the system services 
control point).. Contrast with data flow control. 


H 


half duplex. *(1) In In data coumunication: pertaining to an 
alternate, one way at a time, independent transmission. (2) 
Contrast with duplex. 


host computer. (1) The primary or controlling computer in a 
multiple computer operation. (2) A computer used to prepare 
programs for use on another computer or on another data. 
processing system; for example, a computer used to compile, 
link-edit, or test: programs to be used on another system. (3) In 
a data processing system that includes ACF/VTAM or 
ACF/TCAM, the computer in which ACF/VTAM or 
ACF/TCAM resides... 


host master key. (1) A cryptographic key used to encipher 
operational keys that will be used at the host processor. 
decipher cryptographic session keys. 


ICV. Initial chaining value. 


inactive. In ACF/VTAM, pertaining to a major node that has 


_. not been made known to ACF/VTAM and is unavailable for 


use, or pertaining to a minor node that is not in session with nor 


- available for a session with an application program. Contrast 
with active. | 


initial chaining value (ICV). An 8-byte random number used to 


_ verify that both ends of a cryptographic session have the same 


cryptographic session key. It.is generated by the secondary end 
of the. session upon receipt of a Bind request for a cryptographic 


_ session and is returned to the primary end of the session in the 


Bind response, enciphered under the cryptographic session key 
received in the Bind request. The initial chaining value is also 
used as ihput to the CIPHER macro to encipher or decipher 
data in acryptographic session. 


intensive mode error recording. The recording of information by 


ACF/NCP/VS about temporary errors on SDLC links. In 
addition to recording the initial error status that starts an error 


recovery process and the final error status that causes a 
permanent error record to be generated, intensive mode error 


‘recording causes each temporary error between the initial error — 


and final error to be recorded ina RECMS RU and sent to the 
SS&P.that requested intensive mode error recording. 


intermediate node. In SNA, a physical unit that is capable of 
- routing path information units to another subarea. 


interpret table. In ACF/VTAM, a user-defined correlation list 
that translates an argument into a string of eight characters. 
Interpret tables can be used to translate logon data into the 
name of an application program for which the logon i is 


intended. 


K 


key encrypting key. A cryptographic key used to encipher and 


decipher other cryptographic keys. Contrast with data 


encrypting key. 


L 


lime. See communication line. 


- line control. The scheme of operating procedures and control 


signals by which a data link is controlled. For example, 


synchronous data link control (SDLC). 


line group. One or more communication lines of the same type, 
that can be activated and deactivated as a unit. 


link level 2 test. In ACF/VTAM, a test of a dedicated secondary 
station on a shared link with a shared communications 
controller. . 
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local. (1) Pertaining to the attachment of devices directly by 
I/O channels to a host computer. Contrast with remote. (2) In 
data communication, pertaining to devices that are attached to 
a controlling unit by cables, rather than by data links. 


local address. In SNA, an address transformed to or from a 
network address by the boundary function (for example, in a 
communications controller node) for use by a cluster control 
unit or terminal node. See also network address, boundary 
function. 


local NCP. An NCP that is channel-attached to a host 
processor. Contrast with remote NCP. 


local non-SNA major node. : In ACF/VTAM, a major node whose 


minor nodes are locally-attached non-SNA terminals. 


local SNA major. node. In ACF/VTAM, a major node whose: 
minor nodes are locally-attached physical and logical units.. 


local-to-local link. A data communication link between two local 
communications controllers.. The link can be.either a 
cross-domain link (communications controllers in-different — 
domains) or it can exist within a domain between local 
communications controllers controlled: by the same system : 


services control point. an 
| local 3270 major node. See local non-SNA major node. 


logical error. In ACF/VTAM, an error éondition that feet 


from an invalid request; a program logic error. 


logical unit. In SNA, one of three types of network addressable 
units (NAUs). It is the port through which an end user accesses 
function management in order to communicate with another 


end user. It is also the port through which the end user accesses’ 


the services provided by the system services control point 
(SSCP). It must be capable of supporting at least two 
sessions—one with the S SCP, and one with another logical unit. 
It may be capable of supporting many sessions with other: 
logical units. ACF/VTAM application programs must 
communicate with logical units in record mode. See also 
physical unit, system services control point. 


log off. In ACF/ VTAM, to request that a session be 
terminated. 


logoff. In ACF/VTAM, a request that a session be terminated. 


log on. In ACF/ VTAM, to request that a session be established 


between an application program and a logical unit. 


logon. In ACF/VTAM, a request that a session be established | 
between an application program and a logical unit. See also 
automatic logon and simulated logon. 


logon data. In ACF/VTAM: (1) The data portion of a 
field-formatted or character-coded logon from a terminal. (2) 
The entire logon sequence or message from a non-SNA 
terminal. | 


logon-interpret routine. In ACF/VTAM, a user-written exit 


. routine, associated with a logon-interpret table entry, that 


translates logon data. Synonymous with APPLID routine. 
logon message. Synonym for logon data. 


logon mode. A subset of session parameters specified in a logon 
mode table for communication with a logical unit. See also 
Session parameters. 


logon mode table. In-ACF/VTAM, a set of entries for one or 
more logon modes. Each logon mode is associated with a logon 
mode name. 


LU. Logical unit. 
LU-LU session. In SNA, a session between two logical units in 


the network. It provides communication between two end 
users, each associated with one of the logical units. 


major node. In ACF/VTAM, a set of minor nodes that can be 
activated and deactivated as a group. See also minor node. 


message. (1) *An arbitrary amount of information whose 
beginning and end are defined or implied. (2) (SC1) A group of 


characters and control bit sequences transferred as an entity. 
_(3) A combination of characters and symbols transmitted from 


one point to another. 
minor node. In ACF/VTAM, a uniquely-defined resource within - 
a.major node that can be activated or deactivated by the VARY 
command. Synonymous with specific node. See also major 4 
node. , 


modem. (1) (SCI) A functional unit that modulates and 
demodulates signals. One of the functions of a modem is to 
enable digital data to be transmitted over analog transmission 
facilities. (2) *(modulator-demodulator) A device that 
modulates and demodulates signals transmitted over data 
communication facilities. : 


_multiple-channel-attached communication controller. A 


communication controller that is channel-attached to more than 
one host computer. 


multipoint line. A line or circuit interconnecting several stations. 
Contrast with point-to-point line. 


Multisystem Networking Facility. In ACF, a feature that supports © 
communication among multiple host processors operating with 
DOS/VSE, OS/VS1, and OS/VS2. 


multithread application program. An ACF/VTAM application 
program that processes many requests from many logical units 
concurrently. Contrast with single-thread application program. 


N 


NAU. Network addressable unit. 
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NCP. Network control program. 


NCP major node. In ACF/ VTAM, aset of minor nodes 
representing devices (lines, terminals, and cluster control units) 
controlled by a network control program. 


negative response. A response indicating that a request did not — 


arrive successfully or was not processed successfully by the 
receiver in a session. Synonymous with exception response. 
Contrast with positive response. 


negative response to polling limit. Poeaad aang BSC _ 
terminal, the maximum number of consecutive negative. .- 


responses to polling that the communications controller accepts. | 


before suspending polling operations. 


negotiable bind. In SNA, a session-establishrhent protocal that - 
allows the secondary end of the session to accept, reject, or 
change the session parameters. 


network. (1) (SC1) The assembly of equipment through which 


connections are made between terminal installations. (2)In: 


data communication, a configuration in which two or more’ 
Jocations are physically connected for the purpose of 
sxeuense data. 


network address. In SNA, the address, consisting of subarea and: 
element subfields, that uniquely identifies.a link or the location 


of a network addressable unit. The conversion from a local 
address to a network address, or vice versa, is accomplished: as: 
part of the boundary function in the node attached to acluster ° 
control unit or a termine! See local address. See also network 
name. 


network addressable unit (NAU).. In SNA, a logical unit, a. 


physical unit, or a system services control point. Iti is the origin : 


or the destination of information transmitted in the: 

transmission subsystem. Each NAU has a network: address that. 

represents it to the transmission subsystem. The transmission 

- subsystem and the NAUs collectively constitute:the. 

communication aystemt: See also. network name, ‘network 
address. : 


network control (NC). In SNA, a transmission control 
component that permits logically adjacent connection point 
managers to communicate through the common network, using 
sessions established for other purposes and thereby avoiding - 
special session establishment. See also connection gus : 
manager, session control. 


network control mode. The functions of a network control -_ 


program that enable it to-direct a communications controller to. 


perform activities such as polling, device rear one 
and anewerng, See also emulation mode. 


network control program (NCP). A program, generated bi the 
user from a library of IBM-supplied modules, that controls the | 
operation of a communications controller. 


network control program generation. The process, performed in a 


host system, of assembling and link-editing a macro instruction | 


program to produce a network control program. 


network definition. In ACF/VTAM, the process of defining the 
identities and characteristics of each node in the network and 
the arrangement of the nodes. Network definition i is part of 
ACF/ VTAM definition. 


network name. In SNA, the symbolic identifier by which a 


_ network addressable unit or a data link is referred to by end 
users. See also network address. In a multiple-domain network, 


the name of the APPL statement is the network name and must 


be unique across domains. Contrast with ACB name. 


network operator. (1) A person responsible for controlling the 


_ operation of a communication network. (2) An ACF/VTAM | 
application program authorized to issue network operator 

- commands. (3) In a-multiple-domain network, the person or 
program that controls all the domains i in the network. Contrast 
with domain operator. . 


network operator command. A command used:to monitor or 


_ control the communication network. | 


network operator console. A system console or terminal in the 


network from which a network operator controls a 
communication network... 


network operator logon. A logon requested on behalf of a 


terminal by means of a. network operator command. 


NIB. Node initialization block. 


"NIB ist. A series of contiguous node initialization blocks. 


‘no response. In SNA, an indication in the RH for a request unit 
“that no response is to be returned to the request, whether or not 
it is received and processed successfully. Contrast with definite 
- response and exception response. 


node. (1) In SNA, a junction point in a network, represented by 
a physical unit.. Anode contains network addressable units.. (2) - 
In ACF/VTAM, @ point in.a communication network defined 


by a symbolic name. See. also major node and minor node. : 


node initialization block (NIB). In ACF/VTAM, a control block 
- associated with a particular node that contains information | 
used by the application program to identify a node and indicate 


how communication requests directed at the node are to be 
implemented.. 


node name.. In ACF/VTAM, the symbolic name assigned to a 
specific major or minor node during network definition. 


non-SNA terminal. A terminal that does not use SNA protocols.. 


‘normal flow. .In SNA, a data flow designation indicated in the 
. transmission header (TH). Both the primary-to-secondary and 


secondary-to-primary flow are split into normal and expedited 
flows. The expedited flow is independent of and used to control 
the normal flow. Requests and responses on a given flow 
(normal or expedited) are usually processed sequentially within 
the path, but the expedited flow traffic may be moved ahead of © 
the normal flow traffic within the path. Contrast with expedited 
flow. | 
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orderly closedown. The orderly deactivation of ACF/VTAM 
and its domain. An orderly closedown does not take effect until 
all application programs have closed their ACBs. Until then, all 
data transfer operations continue. Contrast with cancel 
closedown and quick closedown. 


P ; 


pacing. (1) In data communication, a technique.by which a 
receiving station controls the rate of transmission of a sending 
station to prevent overrun. (2) In SNA;.a mechanism that 
permits a receiving connection point (CP) manager to control 
the data transfer rate (the rate at which it receives request units) 
on the normal flow. It is used to prevent overloading a receiver 
with unprocessed requests when the sender can generate . 
requests faster than either. the receiver or the network can 
process them. 


patithel seuioa: In ACF/ VTAM, two or more simultaneously. 


active sessions between the same two logical units. Each 
session can employ. a different function : management protocol, 


a different transmission services ia a and have 


independent. session control. 


partitioned emulation programming (PEP): A feature of the: 


network.control program, versions 2 and later, that allows a 
local IBM 3704 or 3705 controller to operate as an IBM 270, 


2702; or 2703 control unit (or any combination of the three) for 


certain data links, while performing network control functions--- 
for other links in the network. 


path. (1) In ACEF/VTAM, the intervening nodes and data links: 
connecting a terminal and‘an application program in the host 
processor. (2) In defining a switched major node, a potential 


dial-out port that can. be.used to reach a physical-unit: (3) In. 
defining path tables, a route through an adjacent subarea to one. 
or more destination subareas. (4) In SNA, ‘the series of nodes, 
data links, and common network components (path control and © 
data link control) that form the complete route traversed by the - 
information exchanged between. two network addressable units - 


in’session. 


path. control (PC). In SNA, one of the ecenponsite of the. 


_ transmission subsystem, and one of two components of the’ 


common network. It is responsible for managing the sharing of 
data link resources of the common network and for routing 
basic information units (BIUs) through it. It is aware of the . 
location of NAUs in the network and of the paths between | 


‘them. It maps:'the BIUs, handled by transmission control, into. 
- path information units (PIUs), and then into basic transmission. 
units (BTUs) that are passed between path. control and data link 
‘control. The unit of control information built by the sending , 
‘path control component and interpreted: by the receiving path 


control component is a transmission header le: See also | 
data link: control, transmission control. 


path information unit (PIU). In SNA, the unit of transmission 
consisting of a transmission header (TH) and either a basic 
information unit (BIU) or a BIU segment. 


path table. A table whose entries contain path information for a 
network node. 


PEP. Partitioned emulation programming. 


physical connection. A point-to-point connection, multipoint 
connection, or switched connection. 


physical unit (PU). In SNA, one of the types of network 
addressable units; a PU is associated with each node that has 
been defined to a system services control point (SSCP). The 
SSCP establishes a session with the physical unit as part of the 
activation process. See also logical unit, system services control 
point. 


PIU.. Path information unit. 

plaintext. Synonym for clear data. 

point-to-point line. A data link that connects.a single remote 
station to the computer; it may be either switched or 
nonswitched. Contrast with multipoint line. 

positive response. A response that indicates a request was 


received and processed successfully. Contrast with negative 
response. 


primary application program. An application program acting as 


the primary end of a session. 


‘primary end of a session. The end of a session that has more 
control of the session through the use of primary protocols. 
Contrast with secondary end of a session. - 


program operator. An ACF/VTAM application program that is 
authorized to issue network operator commands and receive 


ACF/VTAM network operator awareness messages. See 


solicited messages and unsolicited messages. 


protocol. In SNA, the sequencing rules for requests and. 


responses by which network addressable units ina | 
. communication network coordinate and control data transfer 
. operations and other operations. See also bracket protocol. 


~ PU. Physical unit. 


a 


queued for asession. In ACF/VTAM, the state of a logical unit 
_ that has logged on to.an application program but has not yet 
been accepted by that application program. 


quick closedown. In ACF/VTAM, a closedown in which current 
data-transfer operations are completed, while 


’ session-establishment and new data-transfer requests are 


canceled... Contrast with cancel closedown and orderly 
closedown. 


quiesce protocol. In ACF/VTAM, a method of communicating 
in one direction at a time. Either the application program or 
the logical unit assumes the exclusive right to send normal-flow 
requests, and the other node refrains from sending such 
requests. When the sender wants to receive, it releases the 
other node from its quiesced state. 
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RDT. Resource definition table. 


record mode. In ACF/VTAM, the mode of data transfer in 
which the application program can communicate with logical — 
units. Contrast with basic mode. 


release. In ACF/VTAM resource control, to relinquish control | 


of resources (communications. controllers.or physical units). 
See also resource HORSO VER: Contrast with acquire {a}. 


remote. In ACF/VTAM, pertaining to devices that are 
physically connected by a communications line. Contrast with 
local. : : 
remote NCP. An NCP that is not attached directly through a 
channel, but is attached through a data link to a local NCP that 
is channel-attached. Contrast with local NCP and peer NCP... 


request header. See request/response header. 


request parameter list (RPL). In ACF/VTAM, a control block: 


that contains the parameters necessary for processing: a request | 


for data transfer, for establishing or ending a session, or for 
some other operation. | 


request/response header (RH). In SNA,, a control field, attached. 


to a request/response unit (RU), that specifies the type of RU. 
being transmitted—request or: response~and contains control. 
information associated with that RU. See also: request/response 
unit. 


request/response unit (RU). “Tn SNA, the badic unit. of 
information entering and exiting the transmission. subsystem. It 
may contain data, acknowledgment of data, commands that _ 
control the flow of data through the network, or responses to. 
commands. 


request unit. See request sana unit. 


sequined cryptographic session. A aryotoaraphic session in a which 
all outbound data is enciphered and all inbound data is. 
deciphered. Contrast with selective cryptographic session and 
clear s session. 


resource definition table (RDT). In ACF/VTAM, a table that. 
describes the characteristics of each node available to : 
ACF/VTAM and associates each node with an address, CID, or 
-‘ session ID. 


resource takeover. In ACE/ VTAM, thes action of a ‘astwork 
operator to transfer control of resources from one domain to 
another. See also acquire (2) and.release. 


responded output. In ACF/VTAM, a type of output request that 


‘is completed when a response is returned. Contrast with 
Scheduled output. 


response. See request/response unit. 


response header. See request/response header.. 


response unit. In SNA, the request/response unit following a 
response header; it is sent in response to a request unit. 
Synonymous with response.. See also request/response unit. 


RH. Request/ response header. . 


RPL. Request parameter list. | 


RPL-based macro instruction. In ACF/ VTAM, a macro 
instruction whose parameters are specified by the user in a 
request parameter list. 


RPL exit routine. In: ACF/ VTAM, a user-written routine whose 


address has been placed in the EXIT field of a request 


- parameter list. ACF/VTAM invokes the routine to indicate 
that an asynchronous request has been Semestet: See also 


EXLST exit routine. 
RU. Request/response unit. 


~ scheduled. output. In ACF/VTAM, a type of output request that © 
is completed, as far asthe application program is concerned, 
- when the: ‘program: s output data area is free. Contrast with 
. responded output. 


: SDLC. py ncnconcss dats link control. 7 


-SDLC cluster controller. A cluster control unit for a data 
: communication subsystem. 


: secondary application program.. “An: application program acting as 


the secondary end of a session. 


: secondary end of a session: That end of a.session that has less 
control of the session and-uses secondary protocols. For 


example, a terminal, or a secondary application program. 
Contrast with primary application program. 


secondary logical. unit (SLU). key. A primary key. encrypting ec 


used to protect a. cryptographic session key during its 


transmission to the secondary end of the session. © 


selective cryptographic séiiioe! A eepinouranhis session in which: — 
-. an authorized application program is permitted to specify the 
_ enciphering of certain request units. 


sequence number.. A numerical identifier assigned by 


‘ACF/VTAM to each request/response unit exchanged between - 


two nodes. 


Session. (1) The period of. time:during which a user of a 


terminal can communicate with an interactive system; usually, 
the elapsed time between logon and logoff. (2) The period of 
time during which programs or devices can communicate with 


_ each other. (3). In SNA, a logical connection, established 


between two network addressable units (NAUs) to allow them 
to communicate. The session is uniquely identified by a pair of 
network addresses, identifying the origin and destination NAUs 
of any transmissions exchanged during the session. See LU-LU 
session, SSCP-LU session, SSCP-PU session. | | 
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specific node. See minor node. 


session control. In SNA, one of the components of transmission: 
control. It is responsible for allocating resources necessary for 
a session, for purging data flowing in a session if an 
unrecoverable error occurs, and for resynchronizing the data 
flow after such an error. 


session correlation value: In ACF/VTAM, when parallel sessions _ 


are activated, the value returned in the USER field in the NIB 


specified on a SIMLOGON or REQSESS macro instruction. It 


is used to correlate RUs and sessions. — 


session limit. (1) In the network: conical program, the maximum 
number of concurrent line-scheduling sessions on a non-SDLC, 
multipoint line.. (2) In SNA; the maximum numberof 
‘simultaneous sessions a Pacicales network addressable unit can 


| mupport, 


session oirumnctera: The communication penineall ‘hats govern a. 


session between a logical unit and an application program or 
between two eat sa See also a ‘mode. i 


sliare limit. ‘The limit of the: number of SSCPs that can. 
simultaneously share a Tesource. He 


shared. Pertaining to the: svalability of: a resource. to more e than 2 


one use: at: the same time.» 


simulated. esas A Légion eae for a terminal nS 
-ACF/VTAM at the primary application program's request. 


The primary application program accepts or rejects the .. - = 


terminal as if it had logged o on, - 

: single-chanmel-attached aie a atic esas : 
communication controller thati is. channel-attached to: only one 
host computer.: | ‘ ee, aes | Be | 


single-thread application program. An ACF/VTAM application 


program that: processes: ‘requests from terminals one at a time... 
Such a program ‘usually requests. synchronous operations from — 


ACF/VTAM, waiting until each operation is: completed before. 
Broceedmne, Contrast. with multithread y epplicertas program. 


SLU. Secondary logical unit. | 
SNA. Systems network architecture. 


SNA jetediaal: A feet that i iS. s compatible with systems 
metwors Stenson. ve 


SNBU. Switched network backup 


solicited message. A response from ACF/VTAM to a network 
_ operator command entered by a program pecoieas Contrast 
: — unsolicited message. : 


' specific-mode. In ACF/VTAM: (1) The form of request that 
obtains data from one specific terminal. (2) The form of 

‘request that establishes a session with a specific terminal that 
has logged on. (3) Contrast with ony mee: See also 
continue-specific mode. 
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SSCP. System services control point. 


SSCP ID. An identifying number associated with an SSCP (that 
must be unique in a multidomain system) that enables a device 
(especially a dial-in device) to identify an SSCP at a particular _ 
location and enables another SSCP to identify this SSCP when 
establishing a session with it. 


SSCP-LU session. In SNA, a session between a logical unit (LU) 
and the system services control point (SSCP). It is used to 
support logical unit-related control and use of the 
communication system. Each logical unit in the network 


participates in a session with the SSCP that provides services 
for that logical unit. 


SSCP-PU session. In SNA, a session between a physical unit 
(PU) and the system services control point (SSCP) that is used 
to control the physical configuration and to control an 


- individual. node. Each physical unit in the network must | 


participate in a session with the SSCP that provides services for . 
that physical unit. 


start options.. In ACF/VTAM, the user-specified or 


IBM-supplied options that determine certain conditions that are 
to exist during the time an ACF/VTAM system is operating. — 
These options include: the size of ACF/VTAM buffer pools, 
which major and minor nodes are to be traced by the 
ACF/VTAM trace facility, and which major nodes are to be 
made initially active.. Start options can be predefined or 
specified by the network operator when ACF/VTAM is started. 


subarea. A group of network addressable units that have the 


same subarea ID. 


| subarea ID. A subfield of network address. 4 


switched network backup (SNBU). An Spasdal facility that 
allows.a user to specify, for certain types of stations, a switched © 


line t to: be used as an alternate path (backup) if the primary line 


becomes unavailable or unusable. 


switched SNA major node. In ACF/VTAM, a major node whose © 


minor nodes are physical and logical units attached by switched 


SDLC links. 


synchronous data link control (SDLC). A discipline for managing | 
synchronous; transparent, serial-by-bit information transfer , 
over a communication channel. Transmission exchanges may 
be duplex or half duplex over switched or nonswitched data 
links.. The communication channel configuration may be 
point-to-point, multipoint, or loop. : 


synchronous operation. In ACF/VTAM,. a communication, or 
other operation in which ACF/VTAM, after receiving the 
request for the operation, does not return control to the 
program until the operation is completed. Contrast with 
asynchronous operation. 


synchronous request. In ACF/VTAM, a request for a 
synchronous operation. Contrast with asynchronous request. 
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system services control point (SSCP). In SNA, a network 
addressable unit that provides configuration and session 
services via a set of command processors (network services) 
supporting physical units and logical units. The SSCP must be 
in session with each logical unit and each physical unit for 
which it provides services. It also provides services for the 
network operators or administrators who control the | 
configuration. The SSCP is commonly located at a host node. 


systems network architecture (SNA). The total description of the 
logical structure, formats, protocols, and operational sequences. 
for transmitting information units through the communication 
system. Communication system functions are separated into ~ 
three discrete areas: the application layer, the function 
management layer, and the transmission subsystem layer. The 


structure of SNA allows the ultimate origins and destinations of _ 


information—that is, the end users—to be independent of, and 


unaffected by, the specific communication-system services and — 


facilities used for information exchange. 
T 
TC. Teen control. 


telecommunication subsystem. In ACF/ VTAM, a secondary or 
subordinate: network and set of programs that are part of a 


larger telecommunication system; for example, the combination 


consisting of: an SDLC.cluster:controller, its stored programs, 


and its attached terminals. Synonomous with rerminal system.. 


telecommunication:system.. The devices and functions concern : 


with the transmission of data between the central. PROCeaeOs 
unit and the saat located | users... 


terminal. w A device ain ccd with a ee and : 
some kind of display, capable of ‘sending and receiving. 
information over.a communication channel. (2) In. - 
ACF/VTAM, the secondary end of a session; that i ig: a logical 
unit, a BSC device, a local non-SNA. o72 0 De evices or an i. 
application program.. 


terminal component.. A seperately: adidtsescbie part. of a terminal. | 


that. performs an input or output function, such as the display _ 
component of a keyboard-display device-or a printer 
component of a: keyboard-printer device. 


terminal system. In a.data communication network, a terminal 
control unit or a cluster control unit and its attached devices. 
Synonymous with telecommunication subsystem. 


TH. Transmission header. 


transit node. An intermediate node that is capable of routing 
path information units to another domain. 


transmission. In data communication, one or more blocks or 
messages. For BSC devices, a transmission is terminated by an 
EOT character. See also message. 


transmission control (TC). In SNA, one of three components of 
the transmission subsystem. It has three subcomponents: the 
connection point manager, session control, and network 
control. It establishes, controls, and terminates sessions, and 
also controls the flow of information into and out of the. __ 
common network for a session between network addressable. 
units. It provides access to the transmission subsystem; this 
direct access is used by function management components. A — 
transmission control element exists for each active session. See 
also data link pone path control.. 


transmission control character. *(ISO) Any control sates | 
used to control or facilitate transmission of data between data 
terminal equipment. Synonomous with communication control 
Character. 


- transmission header (TH). In SNA, a control field attached toa | 

basic information unit (BIU) or to a BIU segment, and used by — 

_ path control.. It is created by the sending path control . 

- component and interpreted by the receiving path control 
component. See also path information unit. 


transmission subsystem. In SNA, the innermost layer of the 
communication system: It provides the control.in each session 
‘to route and move data units between NAUs, and to manage.: 
‘the NAUs and their interconnecting paths. Its three constituent » 
| parts.are data link: control, path control, and transmission — 
ona See.also application layer and: function management. 


| TS0/VT AM. Time: Sharing Option for the Virtual 
Telecommunications Access Method. 


U 


unformatted system services (USS). A portion of ACF/VTAM 
that translates a character-coded command, such as a logon or 
logoff command, into a field-formatted command for — | 
processing by formatted system services (FSS). Contrast with 
formatted system services (FSS) and character-coded. 


unsolicited message. A network operator message, front 
_ACF/VTAM to a. program operator, that is unrelated to any - 
command entered by the program operator. Contrast with 
solicited message. | 


USS. Unformatted system services. 
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- access method control block (ACB) 34 
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logical unit control block (LUCB) 35 
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ACF/VTAM communication vector table 
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intelligent controller node control 
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local device node control block 
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25 


27 


¢ 


42 
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42 


parameter list (NCSPL) 42 
node control block (NCB) 42 
pool control block (PCB) 42 


‘ process anchor block (PAB) 41 
request parameter header (RPH) 41 
request parameter list (RPL) 43 
request/response unit processing 

element (RUPE) 43 
skeleton destination vector table 
(SDVT) 41 
TOLTEP interface element (TIE) 
trace parameter list (TRCPL) 
trace record (TRAC) 43 
transmission subsystem control block 


43 
43 


(TSCB) 43 
user exit control block 
(UECB) 42, 43 


waiting request element (WRE) 41 


program operator control blocks 
description 39 
program operator control block 


(POCB) 39 
program operator interface area 
(POIA) 40 


program operator message control 
block (POMCB) 40 
program operator message header 


(POHD) 39 
program operator parameter work area 
(POPWA) 40 
program operator reply control block 
(PORCB) 40 | 
program operator work element 
(POWE) 40 


session control blocks 
description 36 
function management control block 
(FMCB) 36 
node initialization block 38 
session information block 36 
ACF/VTAM data extent block (ACDEB) 
ACF/VTAM domain 
definition 3 
establishing sessions 11 
initialization 4 
network configuration deceit tion 7 
processing I/O requests 13 | 
ACF/VTAM operations 
dynamic reconfiguration (DR) 
LUDRPOOL 23 
PUDRPOOL 23 | 
process scheduling services (PSS) 21 
reliability, availability, and 
serviceability (RAS) 23 
shutting down the network 23 
storage management services (SMS) 
BLDPOOL macro instruction 22 
DELPOOL macro instruction 22 
FREESTOR macro instruction 22 
GETSTOR macro instruction 22 
RELSTORE macro instruction 22 
REQSTORE macro instruction 22 
VTALLOC macro instruction 22 
VTFREE macro instruction 22 
ACF/VTAM slowdown processing 121 
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application program interface (APT) 
description 95 
exit routine facilities 
LOGON exit routine 97 
_ LOSTERM exit routine 97 
TPEND exit routine 97 
EXLST exit routines 97 
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